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CHAPTER 1 


GENERAL INFORMATION 


1.1 INTRODUCTION 

The M6800 Macro Assembler is a program that processes source program statements 
written in M6800 assembly language. The Assembler translates these source state¬ 
ments into object programs compatible with the M6800 Linking Loader or the EXbug 
loader, and produces a listing of the source program. The M6800 Macro Assembler 
has been designed to operate on Motorola's 6800 Development System. The MDOS and 
tape versions of the M6800 Macro Assembler also support the M6801 instruction set. 
In addition, this manual describes the M6805 Macro Assembler and the M6809 Macro 
Assembler. Unless explicitly stated otherwise, all information pertaining to 
the M6800 Macro Assembler also pertains to the M6805 and M6809 Macro Assemblers. 
Although the Linking Loader is referred to as the M6800 Linking Loader, it 
supports M6800/6801, M6805, and M6809 programs. 

The versions of the Macro Assembler described in this manual are: 

RASM 3.00 (M6800/M6801 MDOS version) 

RASM 2.2 (M6800 EDOS version) 

RASM 2.2 (M6800/M6801 tape version) 

RASM05 2.00 and 3.00 (M6805 MDOS version) 

RASM09 3.01 (M6809 MDOS version) 

Earlier versions of these products may not support all of the features described 
in this manual. 

1.2 ASSEMBLY LANGUAGE 

The symbolic language used to code source programs to be processed by the 
Assembler is called assembly language. The language is a collection of mnemonic 
symbols representing: operations (i.e., machine instruction mnemonics, directives 
to the assembler, or macro instructions), symbolic names, operators, and special 
symbols. 

The assembly language provides mnemonic operation codes for all machine instruc¬ 
tions in the M6800 instruction set. The M6800 and M6801 instructions are defined 
and explained in the M6800/6801 Programming Reference Manual. The M6805 instruc¬ 
tions are defined and explained in the M6805 Programming Reference Manual. The 
M6809 instructions are defined and explained in the M6809 Programming Reference 
Manual. The assembly language also contains mnemonic directives which specify 
auxiliary actions to be performed by the Assembler. These directives are not 
always translated into machine language. The assembly language also enables 
the programmer to define and use macro instructions which are used to replace a 
single statement with a predefined sequence of statements found in the macro 
definition. 


1-1 



1.3 OPERATING ENVIRONMENT 


The minimum hardware requirements for the Macro Assembler include: 

Motorola 6800 Development system with EXbug monitor 
System console (keyboard and printer/display) 

M6800 EDOS version — EXORdisk I, 16K RAM 
M6800/M6801 MDOS version — EXORdisk II, 24K RAM 
M6800/M6801 Tape version -- Console reader/punch, 16K RAM 
M6805 MDOS version — EXORdisk II, 24K RAM 
M6809 MDOS version — EXORdisk II, 32K RAM 

1.4 ASSEMBLER PROCESSING 

The Macro Assembler is a two-pass assembler. During the first pass, the source 
program is read to develop the symbol and macro tables. During the second pasS: 
the object file is created (assembled) with reference to the tables developed 
in pass one. It is during the second pass that the source program listing is 
also produced. 

Each source statement is processed completely before the next source statement 
is read. As each statement is processed, the Assembler examines the label, 
operation code, and operand fields. The operation code table is scanned for a 
match with a known opcode. If there is no match, the macro definition table 
is scanned. 

During the processing of a standard operation code mnemonic, the standard 
machine code is inserted into the object file. If a macro is being processed, 
the definition is expanded one line at a time and processed as a normal assembV 
language statement as defined above. If an Assembler directive is being 
processed, the proper action is taken. 

Any errors that are detected by the Assembler are displayed before the actual 
line containing the error is printed. Errors are accumulated, and a total numbi 
of errors is printed at the end of each source listing. If no source listing 
is being produced, error messages are still displayed to indicate that the 
assembly process did not proceed normally. 


1-2 



CHAPTER 2 


CODING ASSEMBLY LANGUAGE PROGRAMS 


2.1 INTRODUCTION 

Programs written in assembly language consist of a sequence of source statements. 
Each source statement consists of a sequence of ASCII characters ending with a 
carriage return. Appendix A contains a list of the supported character set. 

2.2 SOURCE STATEMENT FORMAT 

Each source statement may include up to 5 fields: a sequence number, a label 
(or for a comment line), an operation, an operand, and a comment. 

2.2.1 Sequence Number 

The sequence number field is an optional field provided as a programming con¬ 
venience. The sequence number field starts at the beginning of the source line, 
and consists of up to five decimal digits. The value of the number must be less 
than 65536. Sequence numbers must be followed by a space. In MDOS versions of 
the Macro Assembler, sequence numbers will be automatically printed on the source 
listing. EDOS and tape versions of the Assembler will only print the sequence 
numbers under control of the OPT directive. 

Although sequence numbers are optional, they must be consistently used or not 
used for an entire program. If the first source statement has a sequence number, 
then every succeeding source statment must also have a sequence number. If the 
first source statement does not have a sequence number, then no other source 
statement may be numered. 

2.2.2 Label Field 

The label field occurs as the first field of a source statement. The label field 
can take one of the following forms: 

1. An asterisk (*) as the first character in the label field indicates 
that the rest of the source statement is a comment. Comments are 
ignored by the Assembler, and are printed on the source listing 
only for the programmer's information. 

2. A space as the first character indicates that the label field is 
empty. The line has no label and is not a comment. 

3. A symbol character as the first character indicates that the line 
has a label. Symbol characters are the upper case letters A-Z, 
digits 0-9, and the special characters, period (.), dollar sign ($), 
and underscore (_). Symbols consist of one to six characters, 

the first of which must be alphabetic or the special character, 
period (.). Certain special symbols are reserved by the Assembler, 
and will cause an error to be generated if they appear in a label 
field. These reserved symbols are: A, B, and X. For the M6809 
Macro Assembler, the following are also reserved symbols: CC, D, 

DP, PC, PCR, S, U, and Y. For the M6805 Macro Assembler, only A and 
X are reserved. 
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A symbol may occur only once in the label field unless it is used with the SET 
directive. If a symbol does occur more than once in a label field, then each 
reference to that symbol will be flagged with an error. 

With the exception of some directives, a label is assigned the value of the 
program counter of the first byte of the instruction or data being assembled. 

The value assigned to the label may be either relocatable or absolute. 

Chapter 3 contains a complete description of relocation in the Macro Assembler. 

In case the value is relocatable, the label is assigned the appropriate relocatio 
attribute as well. Relocatable labels will have absolute values assigned to then- 
during the link/load process performed with the M6800 Linking Loader. 

Each unique label, undefined symbol, and external reference symbol in a program 
is allocated a ten-byte block in the symbol table. In addition, a ten-byte 
block is allocated for every four references to a symbol, if the cross reference 
option (paragraph 4.20) is in effect. 

2.2.3 Operation Field 

The operation field occurs after the label field, and must be preceded by at 
least one space. The operation field must contain a symbol. Thus, the rules 
governing labels apply to the operation field as v^ell. Entries in the operation 
field may be one of three types: 

Opcode These correspond directly to the machine instructions. 

The operation code includes the "A" or "B" character 
for the accumulator specification. For compatibility 
with other M6800 assemblers, a single space may 
separate the operation code from the accumulator 
designator. For example, "LDA A" is the same as "LDAA". 
Although the M6809 Macro Assembler recognizes the above 
instruction forms (Appendix B.6), the proper form for 
the M6809 instruction "load accumulator A" is "LDA". 

The M6805 Macro Assembler does not recognize the opcode 
format that contains a space. In addition, only 
accumulator "A" is recognized. 

Directive These are special operation codes known to the Assembler 
which control the assembly process rather than being 
translated into machine instructions. 

Macro call These indicate the selection of a previously defined macro 
which is to be inserted in place of the macro call. 

The Assembler first searches for operation codes in an internal table of machine 
operation codes and assembler directives. If no match is found, the macro 
definition table is searched. Therefore, macros should not be given the names 
of existing instruction mnemonics, root mnemonics (such as ADD, SUB, EOR, etc.), 
or directives. If neither of the tables holds the specified operation code, an 
error message is printed. If code is being generated, three bytes of zeros are 
generated for an invalid operation code. 
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2.2.4 Operand Field 


The operand field's interpretation is dependent on the contents of the operation 
field. The operand field, if required, must follow the operation field, and must 
be preceded by at least one space. The operand field may contain a symbol, an 
expression, or a combination of symbols and expressions separated by commas. 

The operand field of machine instructions is used to specify the addressing mode 
of the instruction, as well as the operand of the instruction. The format of 
the operand field for M6800 instructions is summarized in the following table: 


Operand Format 


H6800 Addressing Mode 


no operand 
<expression> 
#<expression> 
<expression>,X 


accumulator and inherent 
direct, extended, or relative 
immediate 
indexed 


For the M6805, the following additional operand formats exist: 


Operand Format 


M6805 Addressing Mode 


<expression>,<expression> 
<expression>,<expression>,<expression> 


bit set or clear 
bit test and branch 


For the M6809, the following additional operand formats exist: 


Operand Format 


M6809 Addressing Mode 


«expression> 
><expression> 
[<expression>] 
<expression> ,R 
<<expression>,R 
><expression> ,R 
[<expression>,R] 
<[<expression>,R] 
>[<expression>,R] 

Q+ 

Q++ 

[Q++] 

-Q 

-Q 

[-Q] 

W1,[W2,...,Wn] 


direct 
extended 

extended indirect 
indexed 

8-bit offset indexed 

16-bit offset indexed 

indexed indirect 

8-bit offset indexed indirect 

16-bit offset indexed indirect 

auto increment by 1 

auto increment by 2 

auto increment indirect 

auto decrement by 1 

auto decrement by 2 

auto decrement indirect 

immediate 


where R is one of the registers PCR, S, U, X, or Y, and Q is one of the registers 
S, U, X, or Y. Wi (i=l to n) is one of the symbols A, B, CC, D, DP, PC, S, U, X, 
or Y. 


The operand fields of assembler directives are described in Chapter 4. The 
operand fields of macros (Chapter 5) depend on the definition of the macro. 
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2.2.4,1 H6800/M68Q1 Addressing Modes . The M6800 includes some instructions 
which require no operands. These instructions are self-contained and employ 
the inherent addressing or the accumulator addressing mode. 

IMMEDIATE ADDRESSING 

Immediate addressing refers to the use of one or two bytes of informa¬ 
tion that immediately follow the operation code in memory. Immediate 
addressing is indicated by preceding the operand field with the pound 
sign or number sign character (#). The expression following the # 
will be assigned one or two bytes of storage, depending on the 
instruction. 

RELATIVE ADDRESSING 

Relative addressing is used by branch instructions. Branches can only 
be executed within the range -126 to +129 bytes relative to the first 
byte of the branch instruction. The actual branch offset is put into 
the second byte of the branch instruction. The offset is the two's 
complement of the difference between the location of the byte immediate' 
following the branch instruction and the location of the destination of 
the branch. Branches to externally referenced symbols or to symbols 
residing outside of the current program section are invalid. 

INDEXED ADDRESSING 

Indexed addressing is relative to the index register. The address is 
calculated at the time of instruction execution by adding a one-byte 
displacement (in the second byte of the instruction) to the current 
contents of the X register. Since no sign extension is performed on 
this one-byte displacement, the offset cannot be negative. Indexed 
addressing is indicated by the characters ",X" following the expression 
in the operand field. Special cases of ",X" or "X" alone, without a 
preceding expression, are treated as "0,X". Since the displacement 
is a one-byte quantity, external references and addresses in sections 
other than BSCT and possibly ASCT are not valid. 

DIRECT AND EXTENDED ADDRESSING 

Direct and extended addressing utilize one (direct) or two (extended) 
bytes to contain the address of the operand. Direct addressing is 
limited to the first 256 bytes of memory. Direct and extended address¬ 
ing are indicated by only having an expression in the operand field. 
Direct addressing will be used by the Macro Assembler whenever possible 
References to BSCT symbols (including external references to BSCT 
symbols) or to ASCT symbols with a value less than 256 will automatical 
be assembled with the direct addressing mode. If a directly-addressabl 
symbol is referenced before it has been defined as being in BSCT (or AS 
less than 256), the instruction will be assembled with the extended 
addressing mode in order to avoid phasing errors. All other cases will 
result in extended addressing mode being used. 
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2.2.4.2 M6805 Addressing Modes . The M6805 includes some instructions which 
require no operands. These instructions are self-contained, and employ the 
inherent addressing or the accumulator addressing mode. 

IMMEDIATE ADDRESSING 

Immediate addressing refers to the use of one byte of information that 
immediately follows the operation code in memory. Immediate addressing 
is indicated by preceding the operand field with the pound sign or 
number sign character (#). The expression following the # will be 
assigned one byte of storage. Since the expression is one byte, 
external references and addresses in sections other than BSCT and 
possibly ASCT are not valid. 

RELATIVE ADDRESSING 

This addressing mode is the same as described for the M6800. 

INDEXED ADDRESSING 

Indexed addressing is relative to the index register. The address is 
calculated at the time of instruction execution by adding a one- or 
two-byte displacement to the current contents of the X register. The 
displacement immediately follows the operation code in memory. If 
the displacement is zero, no offset is added to the index register. 

In this case, only the operation code resides in memory. Since no sign 
extension is performed on a one-byte displacement, the offset cannot 
be negative. Indexed addressing is indicated by the characters ",X" 
following the expression in the operand field. Special cases of ",X" 
or "X" alone, without a preceding expression, are treated as "0,X". 

Some instructions do not allow a two-byte displacement. When this is 
the case, external references and addresses in sections other than BSCT 
and possibly ASCT are not valid. 

DIRECT AND EXTENDED ADDRESSING 

The addressing mode is the same as described for the M6800 with one 
addition. Some instructions do not allow extended addressing. When 
this is the case, external references and addresses in sections other 
than BSCT and possibly ASCT are not valid. 

BIT SET OR CLEAR 

The addressing mode used for this type of instruction is direct, 
although the format of the operand field is different from the direct 
addressing mode described above. The operand takes the form 
<expression 1>, <expression 2>. <expression 1> indicates which bit 
is to be set or cleared. It must be an absolute expression in the 
range 0-7. It is used in generating the operation code. <expression 2 
is handled as a direct address, as described above. 

BIT TEST AND BRANCH 

This combines two addressing modes: direct and relative. The format 
of the operand is: <expression 1>, <expression 2>, <expression 3>. 
<expression 1> and <expression 2> are handled in the same manner as 
described above in "bit set or clear". <expression 3> is used to 
generate a relative address, as described above in "relative addressing 
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2,2.4.3 M6809 Addressing Modes . The M6809 includes some instructions which 
require no operands. These instructions are self-contained, and employ the 
inherent addressing or the accumulator addressing mode. 

IMMEDIATE ADDRESSING 

Immediate addressing refers to the use of one or two bytes of informa¬ 
tion that immediately follow the operation code in memory. Immediate 
addressing is indicated by preceding the operand field with the pound 
sign or number sign (#) -- i.e., #<expression>. The expression 
following the # will be assigned one or two bytes of storage, depending 
on the instruction. All instructions referencing the accumulator "A" 
or "B", or the condition code register "CC", will generate a one-byte 
immediate value. Also, immediate addressing used with the PSHS, PULS, 
PSHU, and PULU instructions generates a one-byte immediate value. 
Immediate operands used in all other instructions generate a two-byte 
value. 

The register list operand does not take the form #<expression> but 
still generates one byte of immediate data. The form of the operand is 

R1 [,R2,...,Rn] 

where Ri (i=l to n) is one of the symbols A, B, CC, D, DP, PC, S, U, X 
or Y. The number and type of symbols vary, depending on the specific 
instruction. 

For the instructions PSHS, PULS, PSHU, and PULU, any of the above 
register names may be included in the register list. The only restrict 
is that "U" cannot be specified with PSHU or PULU, and "S" cannot be 
specified with PSHS or PULS. The one-byte immediate value assigned to 
the operand is determined by the registers specified. Each register na 
sets a bit in the immediate byte as follows: 


Register Bit 


PC 7 

U, S 6 

Y 5 

X 4 

DP 3 

B, D 2 

A, D 1 

CC 0 


(Paragraph 4.24 contains a detailed explanation of immediate expression 
with the PSH/PUL instructions.) 

For the instructions EX6 and TFR, exactly two of the above register 
names must be included in the register list. The other restriction is 
the size of the registers specified. For the EXG instruction, the two 
registers must be the same size. For the TFR instruction, the two 
registers must be the same size, or the first can be a 16-bit register 
and the second an 8-bit register. In the case where the transfer is 
from a 16-bit register to an 8-bit register, the least significant 8 
bits are transferred. The 8-bit registers are A, B, CC, and DP. The 
16-bit registers are D, PC, S, U, X, and Y. The one-byte immediate 
value assigned to the operand is determined by the register names. The 
most significant four bits of the immediate byte contain the value of 
the first register name; the least significant four bits contain the 
value of the second register, as shown by the following table: 
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Register Value (hex) 


D 0 
X 1 
Y 2 
U 3 
S 4 
PC 5 
A 8 
B 9 
CC A 
DP B 


RELATIVE ADDRESSING 

Relative addressing is used by branch instructions. There are two 
forms of the branch instruction. The short branch can only be executed 
within the range -126 to +129 bytes relative to the first byte of the 
branch instruction. The actual branch offset is put into the second 
byte of the branch instruction. The long branch can execute in the 
full range of addressing from 0000-FFFF (hexadecimal) because a two-byte 
offset is calculated and put into the operand field of the branch 
instruction. The offset is the two's complement of the difference 
between the location of the byte immediately following the branch instruc¬ 
tion and the location of the destination of the branch. Branches to 
externally referenced symbols or to symbols residing outside of the 
current program section are only valid for long branches. 

DIRECT AND EXTENDED ADDRESSING 

Direct and extended addressing utilize one (direct) or two (extended) 
bytes to contain the address of the operand. Direct and extended 
addressing are indicated by having only an expression in the operand 
field (i.e., <expression>). Direct addressing will be used by the 
M6809 Macro Assembler whenever possible. References to ASCT expressions 
with values having the most significant byte of the expression the same 
as the current value of the direct page pseudo register (Paragraph 4.27) 
will automatically be assembled with the direct addressing mode. 

References to BSCT symbols (including external references to BSCT symbols) 
will use the direct addressing mode only if the value of the direct page 
pseudo register is zero. If a symbol that follows the above rules is 
referenced before it has been defined, the instruction will be assembled 
with the extended addressing mode in order to avoid phasing errors. All 
other cases will result in extended addressing mode being used. 

Regardless of the criteria described above, it is possible to force the 
Assembler to use the direct addressing mode by preceding the operand 
with the "<" character. Similarly, extended addressing can be forced 
by preceding the operand with the ">" character. These two operand 
forms are: «expression> and ><expression>. There is no restriction on 
the latter form. It will always generate extended addressing. If 
direct addressing is forced, the following checks are made: 

1. If the expression contains an external reference to a section 
other than BSCT, a relocation error will be generated. 
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2. If the expression contains symbols in sections other than 
BSCT, the expression will not be relocated by the M6800 
Linking Loader. A warning message is generated to indicate 
this condition. Thus, the user must ensure that the direct 
page register at execution time is set up properly to 
accommodate direct addressing for such expressions. 

3. If no error or warning message is generated as a result of 
checks 1 and 2, the most significant byte of the expression 
is compared with the direct page pseudo register. If they 
are not the same, a warning message is generated. Again, the 
user must ensure that the direct page register is set up at 
execution time. 

INDEXED ADDRESSING 

Indexed addressing is relative to one of the index registers. The 
general form is <expression>,R. The address is calculated at the time 
of instruction execution by adding the value of <expression> to the 
current contents of the index register. The other general form is 
[<expression>,R]. In this indirect form, the address is calculated at 
the time of instruction execution by first adding the value of 
<expression> to the current contents of the index register, and then 
retrieving the two bytes from the calculated address and address+l. 

This two-byte value is used as the effective address of the operand. 

The allowable forms of indexed addressing are described below. 

Appendix B.5 describes the format of the post-byte (i.e., the byte 
immediately following the opcode) for each of the indexed addressing 
modes. In the description below, R refers to one of the index 
registers S, 1), X, or Y. 

The accumulator offset mode allows one of the accumulators to be 
specified instead of an <expression>. Valid forms are: 

<acc>,R and [<acc>,R] 

where <acc> is one of the accumulators A, B, or D. This form generat 
a one-byte operand (post-byte only). When accumulator A or B is specif 
sign extension occurs prior to adding the value in the accumulator to 
the index register. 

The valid forms for the automatic increment/decrement mode are shown 
below. For each row, the three entries shown are equivalent. 


R+ 

,R+ 

0,R+ 

-R 

,-R 

0,-R 

R++ 

,R++ 

0,R++ 

—R 

,-R 

0,—R 

[R++] 

[,R++] 

[0,R++] 

[-R] 

[,-R] 

[0,-R] 


In this form, the only valid expression is 0. Like the accumulator 
offset mode, this form generates a one-byte operand (post-byte only). 
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The valid forms for the expression offset mode are: 


R 

,R 

<expression>,R 

[R] 

[,R] 

[<expression>,R] 

<R 

<,R 

<<expression>,R 

<[R] 

<[,R] 

<[<expression>,R] 

>R 

>,R 

><expression>,R 

>[R] 

>[,R] 

>[<expression>,R] 


The "<" and ">" characters force an 8- or 16-bit offset, respectively, 
and are described below. If no expression is specified, or if a non- 
relocatable expression with a value of zero is specified, only the post¬ 
byte of the operand is generated. If a non-relocatable expression with 
a value in the range -16 to +15 is specified without indirection, a one- 
byte operand is generated which contains the expression's value, as 
well as the index register indicator. At execution time, the expression's 
value is expanded to 16 bits with sign extension before being added to 
the index register. 

All other forms will generate a post-byte, as well as either a one- or 
two-byte offset which contains the value of the expression. The size 
of the offset is determined by the type and size of the expression. 

ASCT expressions with values in the range -128 to +127 generate an 
8-bit offset. If an ASCT expression contains a symbol that is refer¬ 
enced before it has been defined, the instruction will be assembled 
using a 16-bit offset in order to avoid phasing errors. All other 
cases will result in a 16-bit offset being generated. In the case 
where an 8-bit offset is generated, the value is expanded to 16 bits 
with sign extension at execution time. Because of sign extention, 
even BSCT expressions generate 16-bit offsets. This eliminates the 
possibility of generating incorrect code in the case where a BSCT 
expression has a value of $80 or greater after relocation by the 
Linking Loader. 


Regardless of the criteria described above, it is possible to force 
the Assembler to generate an 8-bit offset by preceding the operand with 
the "<" character. Similarly, a 16-bit offset can be forced by preceding 
the operand with the ">" character. There is no restriction on the ">" 
form. It always generates a post-byte followed by a 16-bit offset. 

If an 8-bit offset is forced, the following checks are made: 

1. If a relocatable expression contains symbols in section 
other than BSCT, a relocation error is generated. The user 
must beware that because of sign extension on eight bit off¬ 
sets, a BSCT expression with a value of $80 or greater after 
relocation will give incorrect results. 

2. If the expression is absolute but has a value outside of the 
range -128 to +127, a byte overflow error is generated. 

The valid forms for the program counter relative mode are exactly the 
same as the expression offset mode, with the exception that the index 
register specification must be "PCR". However, the manner in which 
the offset is generated by the Assembler differs. The Assembler generates 
a relative address which is then used as the 8- or 16-bit offset follow¬ 
ing the post-byte. The relative address is the two's complement of the 
difference between the location of the byte immediately following the 
indexed instruction and the value of the expression. If the expression 
contains any external references or symbols residing outside of the 
current program section, a 16-bit offset is generated. 



If the relative address calculated is not in the range -128 to +127, or 
if the expression references a symbol that has not yet been defined, 
a two-byte offset is generated after the post-byte. A one-byte offset 
is generated if the relative address is in the range -128 to +127. 

Like the expression offset mode, a one-byte offset can be forced by 
preceding the operand with a "<". A ">" forces a two-byte offset. A 
byte overflow error is generated if a one-byte offset is forced when 
the relative address is not in the range -128 to +127. A relocation 
error is generated if a one-byte offset is forced with an external 
symbol or one that contains another section reference. 

The extended indirect mode has the form: 

[<expression>] 

Although extended indirect is a logical extension of the extended 
addressing mode, this mode is implemented using an encoding of the post¬ 
byte under the indexed addressing mode. A post-byte is generated, as 
well as a two-byte offset which contains the value of the expression. 

2.2.4.4 Expressions . An expression is a combination of symbols, constants, 
algebraic operators, and parentheses. The expression is used to specify a value 
which is to be used as an operand. Expressions follow the conventional rules 
of algebra. 

Expressions may contain relocatable or externally defined symbols. However, the 
following rules must be followed in order for the expression to be valid. 

1. Relocatable symbols or expressions cannot be multiplied, divided, or 
operated on with the special two-character operators. 

2. A relocation count is maintained for each program section represented 
within an expression. Adding a relocatable symbol causes the relocation 
count to be incremented; subtracting a relocatable symbol decrements the 
relocation count. After an expression has been evaluated, the following 
criteria must be met: 

a. All section counts except for one must be zero. 

b. The exception section must have a count of either zero or one 
or minus one. 

c. When an expression is used in conjunction with the one-byte 
immediate addressing mode, the indexed addressing mode, or with 
the FCB directive, all section counts except the BSCT count must 
be zero. 

3. One or more external reference symbols may be added or subtracted withou' 
regard to section. 

Only the least significant byte of an externally referenced symbol will be 
operated on by the M6800 Linking Loader when such symbols are used in conjunctioi 
with the immediate addressing mode (one byte immediate operand) or the indexed 
addressing mode. In the immediate addressing mode, only one externally reference 
symbol is allowed. 
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2.2,4.5 Operators . The precedence of the various operators is as follows. 
Parenthetical expressions are evaluated first, with the innermost parentheses 
being processed before the outer ones. Next, the multiplication (*), division (/), 
and all two-character operators have precedence. Of lowest precedence are the 
addition (+) and subtraction (-) operators. Unary minus can only occur at the 
beginning of an expression or immediately before a left parenthesis. Unary minus 
is equivalent in evaluation to putting a zero directly before the minus sign. 

For example, the following expressions are all equivalent: 

-TA61*INDEX+3 

0-TAGl*INDEX+3 

-(TAGl*INDEX)+3 

Operators of the same precedence are evaluated from left to right. All inter¬ 
mediate results in the computation of an expression are truncated to a 16-bit 
integer value. The result of an expression is also a 16-bit integer. Operators 
can operate on numeric constants, single character ASCII literals, and symbols. 

In addition to the normal operators for multiplication, division, addition, 
and subtraction, the Assembler recognizes certain two-character operators. 

These operators are infix operators and have the same precedence as multi¬ 
plication or division. Each two-character operator begins with an exclamation 
point (I) and takes two operands. The following two-character operators are 
defined: 

I" - exponentiation The left operand is raised to the power specified by the 

right operand. If the right operand is zero, the resulting 
value will be "1", regardless of the value of the left 
operand. 

I. - logical AND Each bit in the left operand is logically "ANDed" with the 

corresponding bit in the right operand. 

1+ - inclusive OR Each bit in the left operand is inclusively "ORed" with 

the corresponding bit in the right operand. 

!X - exclusive OR Each bit in the left operand is exclusively "ORed" with 

the corresponding bit in the right operand. 

!< - shift left The left operand is shifted to the left by the number of 

bits specified by the right operand. The left operand is 
zero-filled from the right. 

.'> - shift right The left operand is shifted to the right by the number of 

bits specified by the right operand. The left operand is 
zero-filled from the left, 

;L - rotate left The left operand is rotated left by the number of bits 

specified by the right operand. The most significant bit 
is rotated into the least significant bit position of the 
left operand. 

:r - rotate right The left operand is rotated right by the number of bits 

specified by the right operand. The least significant 
bit is rotated into the most significant bit position of 
the left operand. 
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2.2.4.6 Symbols . Each symbol is associated with a 16-bit integer value which 
is used in place of the symbol during the expression evaluation. Each symbol 
also has associated with it one of the following attributes: 

1. Absolute attribute 

2. Relocatable attribute 

3. External reference (defined in another program) 

4. Named Common name (cannot be used in expressions) 

5. Undefined 

6. SET symbol 

An absolute, relocatable, or undefined symbol may also be used as an external 
definition (to be referenced by another program). 

Certain symbols are special to the Assembler. These special symbols can only be 
used in expressions, and include the following: 

* The asterisk used in an expression as a symbol represents the 

current value of the location counter (the first byte of a multi¬ 
byte instruction). 

NARG This symbol is only valid within a macro expansion. It takes on 
the value of the number of arguments that has been passed to the 
current level of expansion. 

2.2.4.7 Constants . Constants represent quantities of data that do not vary in 
value during the execution of a program. The numeric constants can be in one 
of four bases: decimal, hexadecimal, binary, or octal. 

A decimal constant consists of a string of numeric digits. The value of a decim, 
constant must fall in the range 0-65535, inclusive. Optionally, decimal constan 
may be preceded by the ampersand character (&). The following example shows botl 
valid and invalid decimal constants: 


VALID 

INVALID 

REASON INVALID 

12 

123456 

more than 5 digits 

12345 

12.3 

invalid character 

&65201 

67800 

out of range (> 65535) 


A hexadecimal constant consists of a maximum of four characters from the set of 
digits (0-9) and the upper case alphabetic letters (A-F), and is preceded by a 
dollar sign ($). Hexadecimal constants can also be designated by being succeedef 
by the letter "H". In this case, the first digit of the hexadecimal constant 
must be a numeric so that the constant can be distinguished from a symbol name. 
Hexadecimal constants must be in the range $0000 to $FFFF. The following exampl( 
shows both valid and invalid hexadecimal constants: 


VALID 

INVALID 

REASON INVALID 

$12 

ABCD 

no preceding "$" 

OABCDH 

$G2A 

invalid character 

$001F 

$2F018 

too many digits 
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A binary constant consists of a maximum of 16 ones or zeros preceded by a percent 
sign (%). Binary constants can also be represented by a series of ones and 
zeros succeeded by the letter "B". The following example shows both valid and 
invalid binary constants: 


VALID 

INVALID 

REASON INVALID 

%00101 

1010101 

missing percent 

%1 

%10011000101010111 

too many digits 

lOlOOB 

%210101 

invalid digit 


An octal constant consists of a maximum of six numeric digits, excluding the 
digits 8 and 9, preceded by a commercial at-sign (@). Octal constants can 
also be designated by ending in the letter "0" or "Q". Octal constants must 
be in the ranges @0 to @177777. The following example shows both valid and 
invalid octal constants: 


VALID 


INVALID REASON INVALID 


@17634 @2317234 
377Q @277272 
1776000 23914Q 


too many digits 
out of range 
invalid character 


Character constants can be used in expressions if they are single characters. 
Character constants are preceded by a single quote. Any character, including 
the single quote, can be used as a character constant. The following example 
shows both valid and invalid character constants: 


VALID 

INVALID 

REASON INVALID 

Comment Field 

"VALID 

too long 


The last field of an Assembler source statement is the comment field. This 
field is optional and is only printed on the source listing for documentation 
purposes. The comment field is separated from the operand field (or from the 
operation field if no operand is required) by at least one space. The comment 
field can contain any printable ASCII characters. 

2.3 ASSEMBLER OUTPUT 

The Assembler output includes an optional listing of the source program and an 
optional object file which is in one of the following two formats: EXORciser- 
loadable format or relocatable format. For the MDOS versions of the Macro 
Assemblers, a third object file format exists -- MDOS loadable memory image. 
Appendix E contains the description of the source listing formats. 

The Assembler will normally suppress the printing of the source listing, and 
select the generation of an object output file. These conditions, as well as 
others, can be overridden via options supplied on the command line that invoked 
the Assembler. 
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The assembly source program listing contains the original source statements, 
formatted for easier reading, as well as additional information which is 
generated by the Assembler. Most lines in the listing correspond directly to 
a source statement. Lines which do not correspond directly to source statements 
include: page headings, error messages, expansions of macro calls, or such 
directives as FCB, FCC, and FOB. 

The assembly listing may optionally contain a symbol table or a cross reference 
table of all symbols appearing in the program. These are always printed after 
the END directive if either the symbol table or cross reference table options 
(Paragraph 4.20) are in effect. The symbol table contains the name of each 
symbol, along with its defined value. The cross reference table additionally 
contains the assembler-maintained source line number of every reference to 
every symbol. The format of the cross reference table is shown in Appendix E.3. 
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CHAPTER 3 


RELOCATION AND LINKING 


3.1 INTRODUCTION 

"Relocation" refers to the process of binding a program to a set of memory 
locations at a time other than during the assembly process. For example, if 
subroutine "ABC" is to be used by many different programs, it is desirable to 
allow the subroutine to reside in any area of memory. One way of repositioning 
the subroutine in memory is to change the "ORG" directive's operand field at 
the beginning of the subroutine, and then to re-assemble the routine. A 
disadvantage of this method is the expense of re-assembling ABC. An alternative 
to multiple assemblies is to assemble ABC once, producing an object module which 
contains enough information so that another program (the M6800 Linking Loader) 
can easily assign a new set of memory locations to the module. This scheme offers 
the advantages that re-assembly is not required, the object module is substantially 
smaller than the source program, relocation is faster than re-assembly, and 
relocation can be handled by the Linking Loader (rather than editing the source 
program and changing the ORG directive). 

In addition to program relocation, the Linking Loader must also resolve inter¬ 
program references. For example, the other programs that are to use subroutine 
ABC must contain a jump-to-subroutine instruction to ABC. However, since ABC 
is not assembled at the same time as the calling program, the Assembler cannot 
put the address of the subroutine into the operand field of the subroutine call. 

The Linking Loader, however, will know where the calling program resides and, 
hence, can resolve the reference to the call to ABC. This process of resolving 
inter-program references is calling "linking". 

The relocation and linking scheme was developed to provide the following 
capabilities: 

1. Program relocation 

2. Multiple program linking 

3. Easy development of programs for RAM/ROM environment 

4. Easy specification of any addressing mode 

5. Specification of uninitialized, blank common 

6. Specification of initialized, named common 

Program sections provide the basis of the relocation and linking scheme. There 
are five different sections. They are described below. 

ASCT, or absolute section, is a non-relocatable section. There may be a limited 
number of absolute sections in a user's program. These sections are used to 
allocate or initialize memory locations that are assigned by the programmer 
rather than by the M6800 Linking Loader. ASCT can be used to define the locations 
of PIA's or ACIA's, for example. 

BSCT, or base section, is a relocatable section. There is only one base section. 
The M6800 Linking Loader assigns portions of the base section to each module that 
requires space in BSCT. The base section is generally used for variables that 
are to be accessed using the direct addressing mode. BSCT is restricted to 
memory locations 0-255, inclusive (decimal). 
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CSCT, or blank common, is a relocatable section. There is only one blank common 
section. CSCT is similar to blank common used in FORTRAN. The blank common 
section cannot be initialized. 

DSCT, or data section, is a relocatable section. There is only one data section 
The M6800 Linking Loader assigns portions of this section to each program that 
requires space in DSCT. DSCT is generally used to contain variables which are 
in RAM and are to be accessed using the extended addressing mode. 

PSCT, or program section, is a relocatable section. There is only one program 
section. PSCT is similar to DSCT. However, it is generally used to contain 
program instructions. The use of DSCT and PSCT facilitates creation of programs 
that reside in ROM but access variables in RAM. 

Uninitialized, blank common is placed into CSCT as described above. At times, 
however, it is convenient to have several common areas, each of which may be 
initialized. Therefore, the concept of named common was included in the M6800 
relocation and linking scheme. Named common can be specified in either BSCT, 
DSCT, or PSCT. The size of the named common area that is allocated will be 
the largest of the named common sizes from the program modules that reference it 
A named common block must reside wholly within a single section. 

For a complete description of the M6800 Linking Loader, the M6800 Linking Loader 
Reference Manual should be consulted. 
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CHAPTER 4 


ASSEMBLER DIRECTIVES 


4.1 INTRODUCTION 

The Assembler directives are instructions to the Assembler, rather than 
instructions to be directly translated into object code. This chapter describes 
the directives that are recognized by the Macro Assembler. Detailed descrip¬ 
tions of each directive are arranged alphabetically. The notations used in 
this chapter are: 

{ } Contains a list of elements, one of which must be selected. 

Each choice will be separated by a vertical bar. For example, 
{IFClIFNC} indicates that either IFC or IFNC must be selected. 

[ ] Contains an optional element. If one of a series of elements 

may be selected, the available list of choices will be contained 
within the brackets. Each choice will be separated by a vertical 
bar. For example, [BSCTlDSCTlPSCT] indicates that either BSCT, 
DSCT, or PSCT may be selected. 

XYZ The names of the directives are printed in capital letters. The 
required parts of directive operands will also be printed in 
capital letters. All elements outside of the angle brackets (<>) 
must be specified as-is. For example, the syntactical element 
[<number>,] requires the comma to be specified if the optional 
element <number> is selected. 

< > The element names are printed in lower case and contained in angle 
brackets. The following elements are used in the subsequent 
descriptions: 


<comment> 

A statement's comment field 

<label> 

A statement label 

<expression> 

An Assembler expression 

<expr> 

An Assembler expression 

<number> 

A numeric constant 

<string> 

A string of ASCII characters 

<delimiter> 

A string delimiter 

<option> 

An Assembler option 

<symbol> 

An Assembler symbol 

<sym> 

An Assembler symbol 

<sect> 

A relocatable program section 

<reg list> 

M6809 register list 

<reg exp> 

M6809 register expression 


In the following descriptions of the various directives, the syntax, or format, 
of the directive is given first. This will be followed with the directive's 
description. 
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4.2 ASCT - ABSOLUTE SECTION 


ASCT [<comment>] 

The ASCT directive causes the program counter to be restored to the address 
following the address of the last byte previously allocated to an absolute 
section (or to zero if ASCT is used for the first time). The program counter 
becomes absolute, and subsequent object code will not be relocated. The ASCT 
directive may only be used if a program is being assembled with the relocatable 
option (OPT REL). 

4.3 BSCT - BASE SECTION 


BSCT [<comment>] 

The BSCT directive causes the program counter to be restored to the address 
following the address of the last byte previously allocated to the base section 
(or to zero if BSCT is used for the first time). The program counter becomes 
relocatable within the base section. All symbols that are defined in BSCT will 
be accessed using the direct addressing mode if the symbols are defined prior 
to being referenced. With the M6809 Macro Assembler, direct addressing in BSCT 
is only used if the direct page pseudo register is set to zero (Paragraph 4.27). 
BSCT cannot be larger than 256 (decimal) bytes. The BSCT directive may only be 
used if the program is being assembled with the relocatable option (OPT REL). 

4.4 BSZ - BLOCK STORAGE OF ZEROS 

[<label>] BSZ <expression> [<comment>] 

The BSZ directive causes the Assembler to allocate a block of bytes. Each byte 
is assigned the initial value of zero. The number of bytes allocated is given 
by the expression in the operand field. If the expression contains symbols that 
are either undefined or external references or forward references, or if the 
expression has a value of zero, an error will be generated. 

4.5 COMM - NAMED COMMON SECTION 

<label> COMM {BSCT 1 DSCT 1 PSCT} [<comment>] 

The COMM directive causes the program counter to be restored to the address 
following the address of the last byte previously allocated to the named common 
section specified by the <label> field (or to zero if <label> is used for the 
first time). The program counter becomes relocatable, and subsequent object 
code will be relocated within the named common section. The COMM directive is 
one of the directives that assigns a value other than the program counter to 
the label. 

Named common allows the definition of a group of symbols that are to occupy the 
same area of memory in each of several programs that are to reside in different 
areas of memory. Each symbol is defined as a relative offset from the beginning 
of the named common section. When the relocatable programs are link/loaded via 
the M6800 Linking Loader, each reference to a named common section is relocated 
by the starting address assigned to the section by the Linking Loader. The 
Linking Loader allocates enough memory to accommodate the largest named common 
section defined by any of the linked programs. 
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The COMM directive's <label> field becomes the name of the named common section. 
This symbol cannot be used in any subsequent Assembler expressions. The <label> 
can only appear with other COMM directives within the program. The operand of 
the COMM directive defines what addressing mode will be used to reference 
symbols that are defined in the named common section. Subsequent references to 
the named common section identified by <label> must have the same operand field. 

The COMM directive may only be used if the program is being assembled with the 
relocatable option (OPT REL). 

4.6 CSCT - BLANK COMMON SECTION 

CSCT [<comment>] 

The CSCT directive causes the program counter to be restored to the address 
following the address of the last byte previously allocated to the blank common 
section (or to zero if CSCT is being used for the first time). The program 
counter becomes relocatable, and subsequent memory bytes reserved will be re¬ 
located within the blank common section. No initialization (object code) of 
CSCT is allowed. Only the RMB directive can be used to allocate storage. All 
symbols defined with CSCT will be accessed with the extended addressing mode. 
With the M6809 Macro Assembler, direct addressing can be used to access symbols 
in CSCT if the operand field in which they are referenced is preceded with a "<" 
(Paragraph 2.2.4.3). The CSCT directive may only be used if the program is 
being assembled with the relocatable option (OPT REL). 

4.7 DSCT - DATA SECTION 


DSCT [<comment>] 

The DSCT directive causes the program counter to be restored to the address 
following the address of the last byte previously allocated to the data section 
(or to zero if DSCT is being used for the first time). The program counter 
becomes relocatable, and subsequent object code will be relocated within the 
data section. All symbols defined within DSCT will be accessed with the 
extended addressing mode. With the M6809 Macro Assembler, direct addressing 
can be used to access symbols in DSCT if the operand field in which they are 
referenced is preceded with a "<" (Paragraph 2.2.4.3). The DSCT directive may 
only be used if the program is being assembled with the relocatable option 
(OPT REL). 

4.8 END - END OF SOURCE PROGRAM 

END [<expression> [<comment>]] 

The END directive indicates that the logical end of the source program has been 
encountered. Any statements following the END directive are ignored. If the 
END directive is not encountered before the physical end of the source file is 
found, an error will be generated. However, this error is only a warning. The 
optional expression in the operand field can be used to specify the starting 
execution address of the program. 
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4.9 ENDC - END OF CONDITIONAL ASSEMBLY 


ENDC [<comment>] 

The ENDC directive is used to signify the end of the current level of conditional 
assembly (Paragraph 4.17). Conditional assembly directives can be nested to a 
depth of eight. 

4.10 ENDM - END OF MACRO DEFINITION 

EMDM [<comment>] 

The ENDM directive is used in a macro definition (Paragraph 4.18). Its presence 
indicates the end of the macro definition. 

4.11 EQU - EQUATE SYMBOL TO A VALUE 

<label> EQU <expression> [<comment>] 

The EQU directive assigns the value of the expression in the operand field to 
the label. The EQU directive is one of the directives that assigns a value 
other than the program counter to the label. The label cannot be redefined 
anywhere else in the program. The expression cannot contain any external 
references, forward references, or undefined symbols. The expression may, 
however, be relocatable. 

4.12 FAIL - PROGRAMMER GENERATED ERROR 

FAIL [<string>] 

The FAIL directive will cause an error message to be printed by the Assembler. 

The total error count will be incremented as with any other error. The FAIL 
directive is normally used in conjunction with conditional assembly directives 
for exceptional condition checking. The assembly proceeds normally after the 
error has been printed. The <string> can be optionally specified to describe 
the nature of the generated error. 

4.13 FOB - FORM CONSTANT BYTE 

[<label>] FCB {<expr>[,<expr>,...,<expr>]}[<comment>] 

The FCB directive may have one or more operands separated by commas. The value 
of each operand is truncated to eight bits, and is stored in a single byte of 
the object program. Multiple operands are stored in successive bytes. The 
operand may be a numeric constant, a character constant, a symbol, or an 
expression. If multiple operands are present, one or more of them can be null 
(two adjacent commas), in which case a single byte of zero will be assigned for 
that operand. An error will occur if the upper eight bits of the evaluated 
operands' values are not all ones or all zeros. The expressions may be relo¬ 
catable with respect to BSCT, or may contain BSCT external references. However, 
all other external references or relocatable symbol types are invalid. 
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4.14 FCC - FORM CONSTANT CHARACTER STRING 

[<labe1>] FCC <number>,<string> [<comment>] 

or 

[<label>] FCC <deliniiter><string><delimiter> [<cotnment>] 

The FCC directive is used to store ASCII strings into consecutive bytes of 
memory. Any of the printable ASCII characters can be contained in the string. 

The FCC directive has two formats. The first format requires that <number> be 
a decimal constant in the range 1-255. The comma is required after the decimal 
constant. The <number> specifies the number of characters contained in <string>, 
which begins immediately after the comma. Should <number> be greater than the 
number of characters in the string (e.g., carriage return encountered in line 
before specified number of characters are found), then spaces will be inserted 
to fill the remainder of the string. 

The second format of the FCC directive specifies the string between two identical 
delimiters. The delimiters can be any printable ASCII character. The first non¬ 
blank character after the FCC directive will be used as the delimiter. Thus, if 
the delimiter happens to be a decimal digit, the first character of the string 
cannot be a comma. 

4.15 FOB - FORM DOUBLE BYTE CONSTANT 

[<label>] FDB {<expr>[,<expr>,...,<expr>]}[<comment>] 

The FDB directive may have one or more operands separated by commas. The 16-bit 
value corresponding to each operand is stored into two consecutive bytes of the 
object program. Multiple operands are stored in successive bytes. The operand 
may be a numeric constant, a character constant, a symbol, or an expression. If 
multiple operands are present, one or more of them can be null (two adjacent 
commas), in which case two bytes of zeros will be assigned for that operand. 

4.16 IDNT - RELOCATABLE IDENTIFICATION RECORD 

I DMT <string> 

The IDNT directive is used to create an identification record for the relocatable 
object module. The <string> can be any printable ASCII characters. The end of 
<string> is the terminating carriage return. This identification record can 
subsequently be displayed by the M6800 Linking Loader during the link/load 
process. The IDNT directive only has meaning when the program is being assembled 
with the relocatable option (OPT REL). 

4.17 IFxx - CONDITIONAL ASSEMBLY DIRECTIVES 

{IFClIFNC} <string l>,<string 2> 
or 

{IFEQlIFGElIFGTlIFLElIFLElIFNE} <expression> [<comment>] 

The IFxx directives are used to conditionally assemble a section of a source 
program. The portion of the source program following the IFxx directive up to 
the next ENDC directive is conditionally assembled, depending on the result of 
the string comparisons (first form) or depending on the value of the expression 
in relation to the condition (the second form). 
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The IFC directive will cause the subsequent statements to be assembled if the 
two strings compare. The IFNC directive will cause the subsequent statements 
to be assembled if the two strings do not compare. In either case, if the 
condition is not met (comparison in the first case, and no comparison in the 
second case), the subsequent statements will be excluded from the assembly. The 
beginning of <string 1> is the first non-blank, non-comma character after the 
IFxx directive. The end of <string 1> is the last character before the first 
comma. The beginning of <string 2> is the first character after the first comma. 
The end of <string 2> is the last character before the end of the source line. 
Thus, if the first form of the IFxx directive is used, no comment can appear on 
the source statement. Both <string 1> and <string 2> can be null. <string 1> 
will be null if only a comma is specified after the IFxx directive. <string 2> 
will be null if only a carriage return is found after the comma. 

If the second form of the IFxx directive is used, the subsequent statements will 
be assembled if the expression is: 

IFEQ -- equal to zero 

IFGE — greater than or equal to zero 

IFGT — greater than zero 

IFLE -- less than or equal to zero 

IFLT -- less than zero 

IFNE — not equal to zero 

If the condition is not met, the subsequent statements will be excluded from 
the assembly. 

Conditional assembly directives can be nested to a depth of eight. Chapter 5 
contains a complete description of the IFxx directives. 

4.18 MACR - MACRO DEFINITION 

<label> MACR [C] [<comment>] 

The MACR directive is used to define a macro. All statements following the MACR 
directive up to the next ENDM directive become a part of the macro definition. 

The required label is the symbol by which the macro will subsequently be called. 
The MACR directive is one of the directives that assigns a value other than the 
program counter to the label. Macro names must not be names of existing instruc¬ 
tion mnemonics, root mnemonics (e.g., SUB, EOR, ADD, etc.), or Assembler 
directives. The operand field may optionally contain the letter "C". If the C 
is present, then all comment lines (lines with an asterisk in column 1) will be 
retained in the macro definition. If the C is not specified, then all comment 
lines will be excluded from the definition. Since macro definitions are stored 
in memory, ommitting the C will reduce the memory requirements of the macro 
definition. Macro definitions may not be nested -- that is, another MACR directi 
cannot be encountered before the ENDM directive. Chapter 5 contains a complete 
description of macros. 
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4.19 NAM - ASSIGN PROGRAM NAME 


NAM [<string> [<coniment>]] 

The NAM directive is generally used as the first statement of an assembly 
language program. Its use, however, is optional, and more than one NAM directive 
can be used in a program. The <string> specified will be printed on the heading 
line of each page of the source listing. It will be used as the name in the SO 
record if an absolute EXORciser-loadable program is being created; or it will be 
the name of the relocatable program module (displayed by the M6800 Linking 
Loader) if relocation has been specified. The <string> consists of a maximum of 
six printable ASCII characters. 

4.20 OPT - ASSEMBLER OUTPUT OPTIONS 

OPT <option>[,<option>,...,<option>] [<comment>] 

The OPT directive is used to control the format of the Assembler output. The 
options are specified in the operand field, separated by commas. All options 
have a default condition. Some options are not reset to their default conditions 
at the end of pass one. Some options are allowed to have the prefix "NO" attached 
to them, which then reverses their meaning. Depending on the version of the 
Macro Assembler, most options can be initialized from the command line that 
invoked the Assembler. In the following descriptions, the parenthetical inserts 
specify "DEFAULT", if the option is the default condition, and "RESET", if the 
option is reset to its default condition at the end of pass one. The text in 
the OPTION column of the following table indicates the minimum characters that 
are required to identify the option. Additional characters can be appended to 
the end of an option to make it more readable, depending on programmer preference. 
For example, CL can be CLIST, NOG can be NOGEN, L can be LIST, U can be UNASSEMBLE, 
etc. 


OPTION 


MEANING 


ABS Select absolute MDOS-loadable object output (non- 

relocatable). All relocatable directives are invalid 
if this option is specified. The "REL" and "LOAD" 
options are invalid if this option is used. This option 
is only supported on MDOS versions of the Macro Assemblers. 

CL (DEFAULT, RESET) Print the conditional assembly directives. 


NOCL Do not print the conditional assembly directives. 

CMO Only valid with M6805 Macro Assembler. Allow CMOS 

instructions STOP and WAIT. 


NOCMO (DEFAULT, RESET) 


Only valid with M6805 Macro Assembler. Do not allow 
CMOS instructions STOP and WAIT. 


CRE Print a cross reference table at the end of the source 

listing. This option, if used, must be specified before 
the first symbol in the source program is encountered. 

G Print the code generated for multiple operands of the 

FCB, FCC, and FDB directives. 
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NOG (DEFAULT, RESET) Do not print the code generated for multiple operands 

of the FOB, FCC, and FDB directives, 

L Print the listing from this point on. The "L" option 

causes an internal list counter to be incremented. 

As long as the list counter is greater than zero, the 
subsequent source listing will be printed. If the 
source listing is not specified on the command line tha1 
invoked the Assembler, the L option has no effect when 
encountered within the source program. 

NOL (DEFAULT, RESET) Do not print the listing from this point on (including 

the OPT NOL directive). The "NOL" option causes an 
internal list counter to be decremented. As long as 
the list counter is less than or equal to zero, the 
subsequent source listing will not be printed. Thus, 
the NOL and L options can be nested. For example: 

OPT NOL 

MACl MACR 

OPT NOL 


OPT L 

ENDM 

OPT L 

The listing will be turned off with the first NOL option 
causing the macro definition to be omitted from the 
source listing. The last L option will cause the listin 
to be turned on again, resuming the printing of the 
source program. The NOL and L options within the body 
of the macro are used to suppress printing of the macro 
at expansion time, regardless of the state of the "MEX" 
option, 

LLE=<number> Change the number of characters to be printed per line 

to the decimal number specified. The default value is 7 
the minimum value is 50; and the maximum value is 120. 

LOAD (DEFAULT) Select absolute EXORciser-loadable object output (non- 

relocatable). All relocatable directives are invalid 
if this option is specified. The "REL" and "ABS" option 
are invalid if this option is used. 

M Direct object output into memory. This option cannot 

be used in conjunction with the "REL" option. The 
Assembler will only allow memory to be used for the obje 
output that is beyond the end of the available contiguou 
memory. If an error occurs while placing object code in 
memory (non-existent memory or Assembler memory), an 
error message will be displayed and the "M" option will 
be disabled. This option is not to be confused with "M" 
command line option of the MDOS version of the Macro 
Assembler (see Appendix G.l), 
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Print macro calls 


MC (DEFAULT, RESET) 
NOMC 

MD (DEFAULT, RESET) 
NOMD 
MEX 

NOMEX (DEFAULT, RESET) 
0 (DEFAULT) 

NOO 


P=<number> 

NOP 

REL 

S 

SE 

U 

MOU (DEFAULT, RESET) 


Do not print macro calls. 

Print macro definitions. 

Do not print macro definitions. 

Print macro expansions 
Do not print macro expansions 

Create output module. Since this option is normally 
selected, it need not be specified. It instructs the 
Assembler to create an object module (either in memory 
or in a file). This option can only be used once 
within a source program. 

Do not create object output module. This option is used 
to suppress creation of an output module. This option 
will suppress the creation of the object module even if 
the creation of one was specified on the command line 
that invoked the Assembler. 

Change the number of source statements printed per page 
to the decimal number specified. The default value is 58; 
the minimum value is 10; and the maximum value is 255. 

Suppress paging; ignore PAGE directives and do not print 
headings or page numbers. 

Select relocatable object output. This option indicates 
that the assembly is to be done in the relocatable mode. 
Any object code produced will be in the relocatable 
record format. All relocatable directives are valid if 
this option is specified. The "REL" option should be 
placed before any statement in the source file (other 
than NAM directive or comment lines). The REL option 
is invalid if used with the LOAD, ABS, or M options. 

Print symbol table at end of source listing. This option 
has no effect if the "CRE" option is used. 

Print the user-supplied sequence numbers in the right 
margin of the source listing. This option is ignored 
in the MDOS version of the Macro Assembler which auto¬ 
matically prints the user-supplied sequence numbers. 

Only the EDOS and tape versions of the Macro Assembler 
respond to this option. 

Print the unassembled lines skipped due to failure to 
satisfy the condition of a conditional assembly directive. 

Do not print the lines excluded from the assembly due 
to a conditional assembly directive. 
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Only valid with M6809 Macro Assembler. Print warning 
messages. 

Only valid with M6809 Macro Assembler. Do not print 
warning messages. 

Only valid with MDOS and tape versions of the M6800 
Macro Assembler. Allow M6801 instruction mnemonics 
to be assembled. This option permits the Assembler to 
recognize valid M6801 instruction menmonics 
(Appendix B.2). If "ZOl" is specified, the M6800 
mnemonics will still be recognized and assembled 
properly. In addition, the object code for any M6801 
instructions will also be generated correctly. This 
option can be used more than once in a program. 

Only valid with MDOS and tape versions of the M6800 
Macro Assembler. Disallow M6801 instruction mnemonics. 

If this option is used in conjunction with the Z01 
option, all subsequent M6801 instructions (until another 
Z01 option) will cause errors to be generated. 

4.21 ORG - SET PROGRAM COUNTER TO ORIGIN 

ORG <expression> [<comment>] 

The ORG directive changes the program counter to the value specified by the 
expression in the operand field. Subsequent statements are assembled into 
memory locations starting with the new program counter value. If no ORG 
directive is encountered in a source program, the program counter is initialized 
to zero. If the program is being assembled with the relocatable option (OPT REL), 
the default program counter value is zero and in PSCT. Expressions in the 
operand field can be relocatable. If they are, they may change the program 
counter section, as well as the program counter's value. Expressions cannot 
contain external references, forward references, or undefined symbols. 

4.22 PAGE - TOP OF PAGE 


W (DEFAULT, RESET) 
NOW 
Z01 

NOZ01 (DEFAULT, RESET) 


PAGE 

The PAGE directive causes the Assembler to advance the paper to the top of 
the next page. If no source listing is being produced, the PAGE directive will 
have no effect. The directive is not printed on the source listing. 

4.23 PSCT - PROGRAM SECTION 


PSCT [<comment>] 

The PSCT directive causes the program counter to be restored to the address 
following the address of the last byte previously allocated to the program 
section (or to zero if PSCT is used for the first time). The program counter 
becomes relocatable, and subsequent object code will be relocated within the 
program section. All symbols defined within PSCT will be accessed with the 
extended addressing mode. Direct addressing of PSCT symbols is not possible, 
except with the M6809 Macro Assembler where direct addressing can be used to 
access symbols in PSCT if the operand field in which they are referenced is 
preceded with a "<" (Paragraph 2.2,4,3). The PSCT directive may only be used 
if the program is being assembled with the relocatable option (OPT REL). 
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4.24 REG - DEFINE REGISTER LIST 


<label> REG <reg 1ist> [<comment>] 

The REG directive is only supported by the M6809 Macro Assembler. It assigns 
a value associated with a register list to the label. The REG directive is 
one of the directives that assigns a value other than the program counter to 
the label. The label cannot be redefined anywhere else in the program. 

<reg list> must be of the form: 


R1 [,R2,...,Rn] 

where Ri (i=l to n) is one of the symbols A, B, CC, D, DP, PC, S, U, X, or Y. 

An error message is generated if both U and S are specified. A warning occurs 
if the same register is specified more than once. Register D is the same as 
registers A and B. 

Although <label> may be used in any expression, its value is only meaningful 
when used with the instructions PSHU, PULL), PSHS, and PULS. The operand for 
these instructions can take one of two forms: 

{PSHUIPULUIPSHSIPULS} <reg list> 
or 

{PSHUIPULUIPSHSIPULS} #<reg exp> 

<reg list> is in the same format as defined above. An error message is 
generated if the register list contains a "U", and the instruction is PSHU or 
PULU. Similarly, an error occurs if the register list contains an "S", and the 
instruction is PSHS or PULS. <reg exp> is of the form: 

<sym l>[I+<sym 2>1+...I+<sym n>] 

where <sym i> (i=l to n) must be defined by the REG directive. An error occurs 
if a PSHU/PULU instruction is followed by a <reg exp> that contains a symbol 
previously defined with the REG directive that contained a U in the register list. 
A similar check is made for PSHS/PULS and S. 


Valid Examples 


ALLREG 

REG 

A,B,CC,DP,X,Y,U,PC 

REGXY 

REG 

X,Y 

REGAB 

REG 

A,B 


PSHS 

#ALLREG 


PSHU 

#regxy:+regab 


Invalid Examples 


REGUS REG U,S 

REGU REG U 

PSHU #REGU 
REGLST REG A,B,D 

PSHS #REGU!+REGU 


can't specify both U and S 

can't push U reg. onto U reg. 
duplicate reg. name warning 
duplicate reg. name warning 
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4.25 RMB - RESERVE MEMORY BYTES 


[<1abel>] RMB <expression> [<coniment>] 

The RMB directive causes the location counter to be advanced by the value of 
the expression in the operand field. This directive reserves a block of memory 
the length of which in bytes is equal to the value of the expression. The block 
of memory reserved is not initialized to any given value. The expression cannot 
contain any external references, forward references, or undefined symbols. The 
value of the expression cannot be relocatable. The RMB directive is the only 
storage allocation operation that is allowed in the blank common section, CSCT. 

4.26 SET - SET SYMBOL TO A VALUE 

<label> SET <expression> [<comment>] 

The SET directive assigns the value of the expression in the operand field to 
the label. The SET directive functions like the EQU directive. However, labels 
defined via the SET directive can have their values redefined in another part of 
the program (but only through the use of another SET directive). The SET 
directive is useful in establishing temporary or re-usable counters within macros. 

4.27 SETDP - SET DIRECT PAGE PSEUDO REGISTER 

SETDP <expression> [<comment>] 

The SETDP directive is only supported by the M6809 Macro Assembler. It is used 
to assign a value to the direct page pseudo register at assembly time. The value 
of the least significant byte of the expression is assigned to the direct page 
pseudo register. This value is then used in determining if a particular memory 
reference can use the direct mode of addressing (Paragraph 2.2.4.3). On initial¬ 
ization, the pseudo register is assigned the value zero. Thus, in relocatable 
programs, direct addressing is automatically generated for BSCT symbols unless 
the direct page pseudo register has been changed with the SETDP directive. The 
SETDP directive can be used any number of times in an assembly. Each occurrence 
changes the value of the direct page pseudo register. The expression cannot 
contain any external references, forward references, or undefined symbols. In 
addition, it must be an absolute expression. If the most significant byte of 
the expression is not zero, a warning occurs. However, the direct page pseudo 
register is assigned the value of the least significant byte of the expression, 
anyway. 

It should be carefully noted that the SETDP directive does not affect the Direct 
Page Register at execution time. The user must assume responsibility for 
ensuring that the assembly and run-time values are compatible. In the example: 

SETDP $20 

the direct page pseudo register would be set to $20, causing absolute addresses 
in the range $2000-$20FF to be assembled using the direct addressing mode. 
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4.28 SPC - SKIP BLANK LIMES 


SPC <expression> 

The SPC directive causes blank lines to be inserted into the source listing 
for formatting purposes. The SPC directive is not printed in the listing. 

The number of lines skipped is determined from the expression in the operand 
field. If the number of lines to be skipped would cause the listing to cross 
a page boundary, then the paper will only be advanced to the top of the next 
page. The expression's value must be greater than zero and less than 256. 

The expression cannot contain any external references or undefined symbols. 

The value of the expression cannot be relocatable. A source program line that 
contains only a carriage return will have the same effect in the source listing 
as the directive "SPC 1". 

4.29 TTL - INITIALIZE PAGE HEADING 

TTL [<string>] 

The TTL directive causes the heading to be initialized to the string in the 
operand field. Up to 45 printable characters can be specified in the string. 

If a carriage return is found before the 45th character, the heading will be 
less than 45 characters. The heading will be printed on the top of all 
succeeding pages until another TTL directive is encountered. The heading is 
normally blank except for the Assembler-generated page number. 

4.30 XDEF - EXTERNAL SYMBOL DEFINITION 

XDEF <symbol>[,<symbol>,...,<symbol>] [<comment>] 

The XDEF directive is used to specify that the list of symbols is defined within 
the current source program, and that those definitions should be passed to the 
M6800 Linking Loader so that other programs may reference these symbols. This 
directive is only valid if the program is being assembled with the relocatable 
option (OPT REL). If the symbols contained in the directive's operand field are 
not defined in the program, an error will be generated. 

4.31 XREF - EXTERNAL SYMBOL REFERENCE 

XREF [<sect>:]<sym>[,<sym>,...][,<sect>:<sym>[,<sym> 

The XREF directive is used to specify that the list of symbols is referenced 
in the current source program, but is defined (via XDEF directive) in another 
program. Each <sym> in the operand field of the XREF directive will be 
associated with a program section, as specified by <sect>. The <sect> specifi¬ 
cation and the addressing mode assumed for that section can be any one of the 
following; 

<sect> Addressing mode 

BSCT direct addressing 

DSCT extended addressing 

PSCT extended addressing 

ANY extended addressing 
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For the M6809 Macro Assembler, direct addressing is only generated for BSCT 
symbols if the direct page pseudo register is set to zero (Paragraph 4.27). 

If <sect> is not specified for a symbol, "ANY" will be used as a default. A 
symbol's section attribute is specified by placing the section name (from above 
table) followed by a colon (:) in front of the symbol or list of symbols. 

I^f the XREF directive is not used to specify that a symbol is defined in another 
program, an error will be generated, and all references within the current progra 
to such a symbol will be flagged as undefined. 

If, during the subsequent link/load process, the M6800 Linking Loader detects 
that the section attribute specified for an external reference does not agree 
with the section attribute of the external definition, an error will be generated 
However, this cannot be detected during the assembly process. The use of the 
ANY section (or no section specification at all) will allow the symbol to be 
defined in any section. 
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CHAPTER 5 


MACRO OPERATIONS AND CONDITIONAL ASSEMBLY 


5.1 INTRODUCTION 

This chapter describes the macro and the conditional assembly capabilities of 
the Macro Assembler. These features can be used in any program, regardless of 
whether or not the relocation feature is used. 

5.2 MACRO OPERATIONS 

Programming applications frequently involve the coding of a repeated pattern 
of instructions that within themselves contain variable entries at each iteration 
of the pattern, or basic coding patterns subject to conditional assembly at each 
occurrence may be involved. In either case, macros provide a shorthand notation 
for handling these patterns. Having determined the iterated pattern, the pro¬ 
grammer can, within the macro, designate selectable fields of any statement as 
variable. Thereafter, by invoking a macro, the programmer can use the entire 
pattern as many times as needed, substituting different parameters for the 
designated variable portions of the statements. 

When the pattern is defined, it is given a name. This name becomes the mnemonic 
by which the macro is subsequently invoked (called). The name of a macro 
definition should not be the name of an existing instruction mnemonic, a root 
mnemonic (e.g., SBC, ADD, EOR, etc.), or an Assembler directive. 

The macro call causes source statements to be generated. The generated state¬ 
ments may contain substitutable arguments. The statements that may be generated 
by a macro call are relatively unrestricted as to type. They can be any 
processor instruction, almost any Assembler directive, or any previously defined 
macro. Source statements generated by a macro call are subject to the same 
conditions and restrictions that programmer-generated statements are subject to. 

To invoke a macro, the macro name must appear in the operation code field of a 
source statement, Any arguments are placed into the operand field. By suitably 
selecting the arguments in relation to their use as indicated by the macro 
definition, the programmer causes the assembler to produce in-line coding 
variations of the macro definition. 

The effect of a macro call is the same as an open subroutine in that it produces 
in-line code to perform a predefined function. The in-line code is inserted 
in the normal flow of the program so that the generated instructions are 
executed in line with the rest of the program each time the macro is called. 

An important feature in defining a macro is the use of macro calls within the 
macro definition. The Assembler processes such "nested" macro calls at expansion 
time only. The nesting of one macro definition within another definition, 
however, is not permitted. If macro names are used as arguments, then they can 
only be used in the operation field of a macro definition statement if they are 
to be recognized by the macro processor. Thus, the macro must be defined before 
its appearance in either a source statement's operation field or in the operand 
field of another macro call. 
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In the examples that follow, not all instructions used are recognized by the 
M6805 Macro Assembler. There is no "B" accumulator, and the "A" accumulator 
designator is not always required. However, all of the information that 
follows applies to all Macro Assemblers. 

For example, if the following macros were defined in a program: 

LDAX MACR 
LDX \0 
LDAA 0,X 
ENDM 

LDAXI MACR 

LDAX \0 
INX 

STX \0 
ENDM 

then the statement 

LDAXI VAR 

would generate the code LDX VAR 

LDAA 0,X 
INX 

STX VAR 


The definition of macro consists of three parts: the header, which assigns a 
name to the macro; the body, which consists of prototype or skeleton source 
statements; and the terminator. The header is the MACR directive and its label. 
The body contains the pattern of standard source statements. The terminator 
is the ENDM directive. 

For example, if the following code pattern were used in a program: 


ADDA 

LA+5 

ADCB 

LB+5 

SUBA 

LC 

SBCB 

LD 

ADDA 

LU 

ADCB 

LV 

SUBA 

ALPHA 

SBCB 

BETA 

ADDA 

LW+LX 

ADCB 

LY+LZ 

SUBA 

GAMMA 

SBCB 

DELTA 


then the following macro definition could be used to represent the above pattern 


MACR 


ADDA 

\o 

ADCB 

\1 

SUBA 

\2 

SBCB 

\3 

ENDM 
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Then the previous coding examples could be written using the macro LDM as 
follows: 


LDM LA+5,LB+5,LC,LD 

LDM LU,LV,ALPHA,BETA 

LDM LW+LX,LY+LZ,GAMMA,DELTA 

The Assembler recognizes substitutable arguments by the presence of the back¬ 
slash character (\). Having encountered this identifier, the Assembler examines 
the next character which is used as an argument pointer. Argument pointers must 
be one of the characters in the set of digits 0-9 and the upper case letters 
A-Z. Thirty-six arguments are the maximum number of arguments that can be 
handled by any macro definition. Macro arguments can appear anywhere within a 
source statement of the macro body. 

When specifying a symbol in the label field of a statement within the body of 
a macro, the programmer must be aware that this macro can be used only once, 
since on the second use, the same label will be redefined, causing an error. 
Consequently, the user of labels within the macro definition must be approached 
with caution. Alternatively, the use of Assembler-generated labels, or the 
placement of substitutable arguments in the label field, is recommended. 

The label field, the operation field, and the operand field may all contain 
text and arguments which can be concatenated by simply placing the substitutable 
argument directly in the text with no intervening blanks (e.g., AB\0$E). 
Concatenation is especially useful in the operation field and in the partial sub¬ 
fields of the operand field. As an example, consider a machine instruction such 
as ADD(R), where (R) can assume the designator A or B. The following macro 
definition contains a partial operation field argument, as well as a partial 
operand field: 

ADO MACR 

ADD\0 \1 
AND\0 #\2 
ENDM 

When the in-line coding is generated, the ADD\0 becomes ADDA or ADDB, as 
designated by the argument passed along in the macro's argument field. The 
"AND" instruction is in the immediate mode with the included as part of the 
macro definition. Thus, the call of the macro ADJ defined above with the 
following arguments: 


ADJ A,TAG1,INDEX 

would generate the following source statements when expanded: 

ADDA TAGl 
ANDA #INDEX 
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Macro usage can be divided into two basic parts: definition and calling 
(expansion). The definition of macros has been described above. The calling 
of macros to expand the definition is described below. 

The macro call statement is made up of two basic fields: the operation field 
(contains the macro name) and the operand field (contains substitutable arguments) 
Each operand of a macro call corresponds one-to-one with an argument pointer of 
the macro definition. For example, the LDM macro defined earlier could be invoked 
for expansion (called) by the statement: 

LDM LA+5,LB+5,LC,LD 

where the operand field arguments, separated by commas and taken left to right, 
correspond to the argument pointers "\0" through "\2", respectively. These 
arguments are then substituted in their corresponding positions of the definition 
to produce a sequence of instructions. 

The maximum number of macro arguments is 36. These arguments are represented 
by the argument pointer symbols \0-\9 and \A-\Z in the macro definition. An 
argument can be declared null when calling a macro. However, it must be declared 
explicitly null. Mull arguments can be specified in two ways: by writing the 
delimiting commas in succession with no intervening spaces, or by terminating 
the argument list with a comma and omitting the rest of the argument list. 

A null argument will cause no character to be substituted in the generated 
statements that reference the argument. When a macro argument has multiple 
parts or contains blanks, the argument must be enclosed within parentheses. The 
parenthetical argument must still be delimited with the normal commas. The 
parenthetical argument can contain commas as in the following example: 

LDM (5,X),(6,X),(LAB+1,X),(LAB+2,X COMMENT) 
which would generate the following instructions: 

ADDA 5,X 

ADCB 6,X 

SUBA LAB+1,X 

SBCB LAB+2,X COMMENT 

It can happen that the argument list of a macro extends beyond the end of a 
single line. In this case, a semicolon must be used in place of a comma after 
the last argument to appear on the line. The next argument must then appear in 
the first column of the next line. This allows for continuation lines. It is 
illegal to have a semicolon embedded within the text of a parenthetical argument. 

At times, labels are required within macros. Since normally a label can only 
be used once in the label field, multiple macro expansions with the same label 
will cause multiply defined label errors. One way to avoid this problem is to 
pass the label to the macro as an argument. Each macro call can then be 
parameterized with a different label. Another alternative is to use Assembler¬ 
generated symbols in the label field. These symbols will take on the form 
".nnnnn", where "nnnnn" is a decimal number from 00000 to 65535, inclusive. 

The Assembler will generate a new symbol whenever it encounters ’'\.a" within a 
macro expansion. The "a" must be an alphanumeric character. Each time a new 
symbol is generated in this manner, an internal counter is incremented. Thus, 
subsequent symbols encountered in subsequent macro expansions will be unique. 
Within the same expansion, each reference to the same "\.a" will reference the 
same symbol generated for that expansion. 
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The symbol NAR6 is a special symbol v/hen referenced within a macro expansion. 

The value assigned to NARG is the number of arguments passed to the current 
level of macro expansion. This symbol makes it easy to conditionally assemble 
parts of a macro or to check for error conditions based on the number of passed 
arguments. Paragraph 5.4 contains several examples of macro usage. 

5.3 CONDITIONAL ASSEMBLY 

A section of a program that is to be conditionally assembled must be bounded 
by an IFxx-ENDC directive pair. The source statements following the IFxx 
directive and up to the next ENDC directive will be included as a part of the 
source file being assembled only if the condition specified by "xx" is satis¬ 
fied (true) by the operand field of the IF directive. If the condition proves 
false, the source file will be assembled as if those statements between the 
IFxx and the ENDC directives were never encountered. 

Conditional assembly allows the user to write a comprehensive source program 
that can cover many conditions. Assembly conditions may be specified through 
the use of arguments in the case of macros, and through definition of symbols 
via the SET and EQU directives. Variations of parameters can then cause assembly 
of only those parts necessary for the specified conditions. 

For instance, a program may be assembled in one of two variations of a basic 
form, depending on the type of environment in which it will eventually be used. 
The input/output section of a program, for example, will vary if the program is 
to be used in a disk environment or in a paper tape environment. Conditional 
assembly directives can be used to include and to exclude those I/O sections 
based on a flag set at the beginning of the assembly as shown in the following 
illustration of a hypothetical program's structure. 


* DEVTYP = 0 MEANS DISK I/O 

* N0T= 0 MEANS TAPE I/O 


IFEQ DEVTYP 

! DISK I/O SOURCE STATEMENTS 
ENDC 

IFNE DEVTYP 

! TAPE I/O SOURCE STATEMENTS 
ENDC 

When the program above is assembled, one of the I/O sections will be included 
and one will be excluded from the source file based on the assembly-time value 
of the symbol "DEVTYP". If the assembly statement: 

DEVTYP EQU 0 

is placed into the source file prior to any conditional directive references 
to that symbol, the disk I/O section will be included and the tape I/O section 
will be excluded. Similarly, if the statement: 
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DEVTYP EQU 1 


is placed into the source file, the disk I/O section will be excluded and the 
tape I/O section will be included. 

Any of the conditional directives could have been used to effect such a result. 
Instead of the "equal" and "not equal" conditions, the "greater than" and "less 
than or equal to" conditions could have been used, etc. 

Conditional directives can also be used within a macro definition to ensure at 
expansion time that the required number of arguments was passed. Specific 
arguments can be tested to ensure that they fall within a given range of 
allowable values. In this way, macros can become self-checking and generate 
error messages to any desired level of detail. The next section contains several 
examples of conditional assembly directive usage. 

5.4 EXAMPLES OF MACROS/CONDITIONAL ASSEMBLY 

The following example illustrates the use of a macro and conditional assembly 
within the macro to check for errors. The macro is used to generate a series of 
equates for PIA's. The PIA's are assumed to be numbered from 1 to 48 (decimal), 
inclusive. The addresses of the PIA's start at location $EE00. PIA number 01 
occupies locations $EE00-$EE03, PIA number 02 occupies locations $EE04-$EE07, 
etc. It would be cumbersome to enter all of the equates for all PIA's by hand. 
Thus, the following macro can be included in a program and invoked to generate 
those equates required for a given set of PIA's. Error messages are generated 
via the FAIL directive. The operand field of the FAIL directive is used to 
identify the error. The example contains sufficient comments to document how 
the macro works. Following the macro definition are examples of the macro's 
usage. The example was assembled using the options: 

OPT MEX,N0CL 

to show the results of the expansion (MEX) and to improve visibility by not 
printing the conditional directives (NOCL). 
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00001 

00002 

00003 

00004 

00005 

00006 

00007 

00008 

00009 

00010 

00011 

00012 

00013 

00014 

00015 

00016 

00017 

00018 

00019 

00020 

00021 

00022 

00023 

00024 

00025 

00026 

00027 

00028 

00029 

00030 

00031 

00032 

00033 

00034 

00035 

00036 


+ 

* THE PIfl EQUATE MACRO TAKES ONE ARGUMENT. THE 

* ARGUMENT MUST BE A DECIMAL NUMBER BETWEEN 1 AND 

* 48. INCLUSIVE. THE NUMBER MUST BE TWO DIGITS 
+ < I. E. . 01. 02. 03.... . 47. 48>. 

iH 

* ERRORS WILL BE GENERATED IF ARGUMENT IS MISSING 

* IF TOO MANY ARGUMENTS ARE SUPPLIED. OR IF 
=♦= THE ARGUMENT IS OUTSIDE OF THE RANGE 01-48. 

* 

>*= THE MACRO WILL GENERATE FOUR EQUATES EACH 

♦ TIME IT IS INVOKED. THE GENERATED EQUATES 

♦ WILL BE FOR THE DATA AND THE CONTROL REGISTERS 
=♦= FOR BOTH A AND B SIDES OF THE PI A. 

♦ 

PIA MACR 

>♦: 

* IF "NARG-1" IS ZERO. ONLY ONE ARGUMENT 

+ WAS PASSED TO THE MACRO. AS REQUIRED. IF 
=♦= "NARG-1" IS NOT ZERO. TOO FEW OR 

* TOO MANY ARGUMENTS WERE PASSED <ERROR). 

IFNE NARG-1 

FAIL *TOO FEW OR TOO MANY ARGS* 

ENDC 

* 

* THE FOLLOWING THREE BLOCKS OF CONDITIONALS 

* ARE USED TO CHECK FOR OTHER ERRORS. THEY WILL 

* ONLY BE USED IF THE CORRECT NUMBER OF ARGUMENTS 

* WERE PASSED TO THE MACRO <I.E. . "NARG-1" = 8). 

>♦< 


He THE NEXT CONDITIONAL TESTS FOR AN ARGUMENT 
He VALUE LESS THAN OR EQUAL TO ZERO < INVALID). 
:+= THE "&" IS USED TO FORCE CHECKING FOR A 
He VALID. DECIMAL NUMBER 


00037 

00038 

00039 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

00053 


IFEQ NARG-1 
IFLE iiS0 
FAIL HePIA <= 0He 
ENDC 
ENDC 

H« 

He THE NEXT CONDITIONAL TESTS FOR AN ARGUMENT 
He GREATER THAN 48. IF "\0-49" IS GREATER THAN OR 
He EQUAL TO ZERO. THE ARGUMENT WAS GREATER THAN 48 
He (INVALID). 


IFEQ NARG-1 
IFGE &\0-49 
FAIL H«PIA > 
ENDC 


48He 
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00054 

00055 

00056 

00057 

00058 

00059 

00060 

00061 

00062 

00062 

00064 


ENDC 

* THE FOLLOWING CONDITIONALS ARE ONLY TRUE 

* IF NO ERRORS WERE ENCOUNTERED ABOVE. THE 

* SAME TESTS ARE USED, BUT THE OPPOSITE CONDITION 

* IN ORDER TO REVERSE THE MEANING OF THE TEST. 

It! 

IFEQ NARG-1 

IFGT &S0 . ENSURE DECIMAL NUMBER > 0 

IFLT &S0-49 . ENSURE DECIMAL NUMBER < 49 

>l! 


00065 * GENERATE THE ACTUAL EQUATES 

00066 >t! 


00067 

P\0AD 

SET 

$EE00+<S0- 

-l>*4+0 . 

PIA 

S0 

DATA/DD 

A 

00068 

PS0AC 

SET 

|:EE00+<S0- 

■l>!t!4 + l . 

PIA 

S0 

CONTROL 

A 

00069 

PS0BD 

SET 

fEE00+<:\0- 

■l>*4+2 . 

PIA 

\0 

DATA/DD 

B 

00070 

PS0BC 

SET 

$EE00+<S0- 

-l>!t!4 + 2 . 

PIA 

\0 

CONTROL 

B 


00071 =t! 


00072 

00072 

00074 

00075 

00076 


ENDC 

ENDC 

ENDC 

ENDM 


00077 



* ILLUSTRATE 

USE OF MACRO TO GENERATE 

EQUATES 


00078 



* FOR 

PIA NUMBERS 01 AND 04 





00079 



>t: 







00080A 

0000 



PIA 

01 







EE00 

A P01AD 

SET 

$EE00+<!01—1!-'!+=4+0 . 

PIA 

01 

DATA/DD 

A 



EE01 

A P01AC 

SET 

T-£E00+< 01-1 >+4+1 . 

PIA 

01 

CONTROL 

A 



EE02 

A P01BD 

SET 

$EE00+':;01--l>+4+2 . 

PIA 

01 

DATA/DD 

B 



EE.02 

A P01BC 

SET 

*:EE00+< 01-1 >+4+2 . 

PIA 

01 

CONTROL 

B 

00081A 

0000 



PIA 

04 







EE0C 

A P04AD 

SET 

$EE00+<04-1>+4+0 . 

PIA 

04 

DATA/DD 

A 



EE0D 

A P04AC 

SET 

$EE00+<04-1>+4+1 . 

PIA 

04 

CONTROL 

A 



EE0E 

A P04BD 

SET 

$EE00+<04-1>+4+2 . 

PIA 

04 

DATA/DD 

B 



EE0F 

A P04BC 

SET 

$EE00+<04-1>+4+2 . 

PIA 

04 

CONTROL 

B 


00082 

00082 

00084 

00085 

00086A 0000 
>|j:tcHe:t:ERROR 

00087 

00088 

00089 

00090 

00091A 0000 
=+!!t=*!t:ERROR 

00092 

00092 

00094 

00095 


5t! 

* 

!ti 

!t! 

55“00000 

Sf! 

+. 

♦ 

* 

55—00086 

>|! 

* 

* 


THE FOLLOWING USE OF THE MACRO ILLUSTRATES 
THE ERROR CHECK FOR NO ARGUMENTS PASSED 

PIA 

FAIL >t:TOO FEW OR TOO MANY ARQS* 

THE FOLLOWING USE OF THE MACRO ILLUSTRATES 
THE ERROR CHECK FOR PIA NUMBER LESS THAN 01 

PIA 00 

FAIL HcPiA <= 0=t< 

THE FOLLOWING USE OF THE MACRO ILLUSTRATES 
THE ERROR CHECK FOR PIA NUMBER GREATER THAN 48 
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000968 0000 

255—00091 


PIfi 


49 


00097 

00098 

00099 

00100 

00101ft 0000 
>Kif**ERROR 


FftIL >t:PIft > 48* 

* THE LftST USE OF THE MftCRO ILLUSTRftTES 

* THE ERROR CHECK FOR TOO MftNV ftRGUMENTS 

* 

Plft 01,04 

255—00096 


FftIL *TOO FEW OR TOO MftNV ftRGS* 
00102 END 

TOTftL ERRORS 00004—00101 


The following example illustrates the use of the Assembler-generated labels 
within macros. The generated code in itself is meaningless in this example. 
However, it does validly show how several invocations to the same macro cause 
different labels to be created. 

In this example, no error checking is performed within the macro to ensure 
that an argument was passed. Thus, if the macro is called without a supplied 
argument, the "\0" argument pointer will be replaced with a null string (removed) 
in the generated "JSR" statement. The operand of the JSR will then become the 
period symbol which was intended to be the first part of a comment. Since 
is a valid Assembler symbol, an undefined symbol error would be generated if 
the macro were called without an argument. 

The following assembly was generated using the options: 

OPT MEX,N0CL 

to show the results of the expansion (MEX) and to improve visibility by not 
printing the conditional directives (NOCL). 
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00001 

00002 

0000 :$ 

00004 

00005 

00006 

00007 

00008 

00009 

00010 

00011 

00012 

00013 

00014 

00015 

00016 

00017 

00018 

00019 

00020 

00021 

00022 

00023 

00024 

00025 

00026 

00027 

00028 

00029 

00030 

00031 


♦ THE "CALL" MACRO IS USED TO CALL A 

♦ SUBROUTINE FOR AN 170 FUNCTION. PRESUMABLV 

♦ THE 170 FUNCTION RETURNS AN ERROR STATUS IN 

♦ THE CONDITION CODE REGISTER. IF THE CARRY 

=♦= FLAG IS SET TO 1 , AN ERROR IS INDICATED. IF 

♦ THE CARRY FLAG IS RESET TO 0 , A NORMAL RETURN 

♦ IS INDICATED. 

♦THIS MACRO WILL GENERATE A CALL TO THE FUNCTION 

♦ FOLLOWED BY A JUMP INSTRUCTION TO THE ERROR 

♦ PROCESSOR. SINCE THE ERROR PROCESSOR IS 

♦ MOST LIKELY OUT OF RANGE FOR A BRANCH 

♦ INSTRUCTION. AN UNCONDITIONAL JUMP MUST BE 

♦ USED. THE MACRO WILL AUTOMATICALLY CREATE 

♦ INTERMEDIATE LABELS TO BRANCH AROUND THE 

♦ JUMP INSTRUCTION. 

♦ 

CALL MACR 
JSR \0 . PERFORM 170 
BCC S. 0 . CC =:> NO ERROR 
JMP ERROR . CS => ERROR 
S. 0 EQU ♦ . GENERATED LABEL 
ENDM 

♦ 

♦ USING THE "CALL” MACRO 

♦ 

* 

♦ DEFINE FICTITIOUS ENTRY POINTS TO THE 

♦ INPUT.. OUTPUT. AND ERROR ROUTINES. 

♦ 


00032 



2000 

A 

INPUT 

EQU 

$2000 

. INPUT ROUTINE 

00033 



3000 

A 

OUTPUT 

EQU 

$3000 

. OUTPUT ROUTINE 

00034 



4000 

A 

ERROR 

EQU 

$4000 

. ERROR PROCESSOR 

00035 





♦ 




00036A 

0000 





CALL 

INPUT 


A 

0000 

BD 

2000 

A 


JSR 

INPUT 

. PERFORM 170 

A 

0003 

24 

03 0008 


BCC 

. 00000 

. CC => NO ERROR 

A 

0005 

7E 

4000 

A 


JMP 

ERROR 

. CS => ERROR 




0008 

A 

. 00000 

EQU 


. GENERATED LABEL 

00037A 

0008 





CALL 

OUTPUT 


A 

0008 

BD 

3000 

A 


JSR 

OUTPUT 

. PERFORM 170 

A 

000B 

24 

03 0010 


BCC 

. 00001 

. CC =:> NO ERROR 

A 

000D 

7E 

4000 

A 


JMP 

ERROR 

. CS => ERROR 




0010 

A 

. 00001 

EQU 

♦ 

. GENERATED LABEL 

00038A 

0010 

20 

FE 0010 


BRA 

♦ 



00039 END 


TOTAL ERRORS 00000-00000 
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The next example utilizes the string forms of the conditional assembly 
directives (IFC and IFNC). Strings passed as macro arguments tend to be more 
meaningful than numerical values since they can be descriptive to specify a 
condition's state. The example could just as well have been written using the 
value 0 instead of the string "RESET", the value 1 instead of the string "SET", 
and the value 2 instead of the string "STORE". The comments in the example 
explain how the macro is used. Following the macro's definition are examples 
of the macro's usage. 

The following example was assembled with the options: 

OPT MEX,N0CL 

to show the results of the expansion (MEX) and to improve visibility by not 
printing the conditional directives (NOCL). 


00001 

00002 

00003 

00004 

00005 

00006 

00007 

00000 

00009 

00010 

00011 

00012 

00013 

00014 

00015 

00016 

00017 

00018 

00019 

00020 

00021 

00022 

00023 

00024 

00025 

00026 

00027 

00028 

00029 

00030 

00031 

0ei032 

00033 

00034 

00035 


♦ 

* THE FOLLOWING MRCRO ILLUSTRATES THE USE 

=+= OF THE STRING FORM OF THE CONDITIONAL ASSEMBLV 

* DIRECTIVES. AN ARGUMENT IS PASSED TO THE 
:♦= MRCRO AS A CHARACTER STRING. BASED ON THE 

* VALUE OF THE CHARACTER STRING.. THE MACRO 

* WILL GENERATE DIFFERENT SEQUENCES OF CODE. 

St: 

St: IF THE ARGUMENT "SET" IS SPECIFIED.. THE 
St: INDICATED VARIABLE IN MEMORV WILL BE 
St: FILLED WITH A PATTERN OF $FF. 

St: THE VARIABLE NAME IS PASSED AS AN ARGUMENT 
St: TO THE MRCRO ALSO. 

• 4 : 

St: IF THE ARGUMENT "RESET" IS SPECIFIED.. THE 
St: INDICATED VARIABLE IN MEMORV WILL BE 
St: FILLED WITH A PATTERN OF $00. 

St: THE VARIABLE NAME IS PASSED AS AN ARGUMENT 
St: TO THE MACRO ALSO. 

St: 

St: IF THE ARGUMENT "STORE" IS SPECIFIED. THE 
St: INDICATED VARIABLE IN MEMORV WILL BE 
St: FILLED WITH A GIVEN VALUE OR PATTERN. 

St: THE NAME OF THE VARIABLE AND THE 

St: VALUE TO BE STORED ARE PASSED AS ARGUMENTS 

St: TO THE MACRO ALSO. 

St! 

St: AN ERROR WILL BE GENERATED IF A STRING 
St: OTHER THAN "SET".. "RESET".. OR "STORE" IS 
St: SPECIFIED AS AN ARGUMENT. 

St: 

BVTE MACR 

St: 

St: CHECK FOR VALID ARGUMENT STRING 

St: 


5-11 



00036 

00037 

00038 

00039 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

00053 

00054 

00055 

00056 

00057 

00058 

00059 

00060 

00061 

00062 

00063 

00064 

00065 

00066 

00067 

00068 

00069 

000708 

fl 

R 

00071 

00072 

00073 

00074R 

R 

00075 

00076 

00077 

00078fl 

fl 

fl 

fl 

fl 

00079 

00080 

00081 

00082fl 


IFNC S0, SET 
IFNC \0, RESET 
IFNC S0, STORE 

FAIL >♦= INVALID STRING ARGUMENT* 
ENDC 


ENDC 

ENDC 

4c 

* CHECK FOR "RESET" ARGUMENT 

* 

IFC \0.. RESET 

CLR SI . SET BVTE TO ZERO 
ENDC 

>te 

* CHECK FOR "SET" ARUGMENT 

* 


IFC S0.. SET 

CLR SI . SET BVTE TO ZERO 
COM SI . FLIP TO ALL ONES 
ENDC 


* CHECK FOR "STORE" ARGUMENT 

4c 


IFC S0.. STORE 

PSHA . SAVE ACCUMULATOR 

LDAA #S1 . GET VALUE 

STAR S2 . STORE VALUE 

PULA . RESTORE ACCUMULATOR 

ENDC 

:+! 

ENDM 

4: 

* USE THE MACRO TO "SET" TEMPI TO ALL ONES 

4: 

0000 BVTE SET.. TEMPI 

0000 7F 0010 fl CLR TEMPI . SET BVTE TO ZERO 

0003 73 0010 fl COM TEMPI . FLIP TO ALL ONES 

4c 

* USE THE MACRO TO "RESET" TEMP2 TO ALL ZEROES 

* 

0006 BVTE RESET. TEMP2 

0006 7F 0011 A CLR TEMP2 . SET BVTE TO ZERO 

4: 

* USE THE MACRO TO "STORE" ASCII "A' INTO TEMP3 


0009 BVTE 

0009 36 PSHA ’ 

000A 86 41 fl LDAA 

000C B7 0012 A STAR 

000F 32 PULA 


4c 


STORE.. - A.. TEMP3 

. SAVE ACCUMULATOR 
#^A . GET VALUE 

TEMP3 . STORE VALUE 

. RESTORE ACCUMULATOR 


* USE AN INVALID STRING TO SHOW ERROR CHECK 

4c 


0010 


BVTE FILL. A. B. C 
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FfilL +INVALID STRING ARGUMENT* 


*:+:*+.ERR0R 255-00000 

t.1000^ •+• 


00084 

00085 

00086A 

0010 

0001 

A 

* VARIABLES 

* 

TEMPI RMB 

1 

00087A 

0011 

0001 

A 

TEMP2 

RMB 

1 

00088A 

0012 

0001 

A 

TEMP3 

RMB 

1 

00089 
TOTAL 1 

ERRORS 00001- 

-00082 

END 



The last example illustrates macro nesting and macro recursion. Nesting refers 
to calling one macro from within another macro. Recursion refers to calling 
the same macro from within itself. A recursive macro must have some criterion 
that can be tested by a conditional assembly directive to prevent infinite 
recursion. Since macros can only be nested eight levels, the recursive macro 
can only call itself a maximum of seven times. 

The comments in the example will explain how the macro is used. Following the 
macro definitions are examples of the macro's usage. The example was assembled 
with the assembly options: 


OPT MEX, NOCL 

to show the results of the expansion (MEX) and to improve visibility by not 
printing the conditional directives (NOCL). Within the macro itself the MEX 
and NOMEX options are used to further clarify the generated expansions by 
suppressing the printing of the intermediate results of decrementing the 
recursion counter. 


00001 

00002 

00003 

00004 

00005 

00006 

0000 ? 

00008 

00009 

00010 

00011 

00012 

00013 

00014 

00015 

00016 

00017 

00018 

00019 

00020 


* 

* THE FOLLOWING MACRO CAN BE USED TO REPEAT 

* AN ASSEMBLY LANGUAGE STATEMENT A MAXIMUM 

* OF 42 TIMES. THE MACRO MAY BE EASILY 

* MODIFIED FOR A LARGER MAXIMUM. 

* 

* THE REPEAT MACRO INVOKES ANOTHER MACRO WHICH 

* IS USED TO REPEAT THE ASSEMBLY STATEMENT 

* A MAXIMUM OF 7 TIMES CHENCE THE NAME 

+ RPT1_7;>. THE REPEAT MACRO MAINTAINS A COUNTER 

* WHICH IS DECREMENTED BY 7 EACH TIME THE 

* INNER MACRO IS CALLED. WHEN THE COUNTER 

* HAS A VALUE OF 7 OR LESS.. THE 

* INNER MACRO IS CALLED ONE FINAL TIME TO FINISH 

* THE REPETITION OF THE REMAINING LINES. 

■* 

REPEAT MACR 
OPT NOMEX 
IFGT S0-42 

FAIL * COUNT EXCEEDS MAXIMUM * 
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00021 

00022 

00022 

00024 

00025 

00026 

00027 

00028 

00029 

00020 

00021 

00022 

00022 

00034 

00025 

00026 

00027 

00028 

00029 

00040 

00041 

00042 

00042 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

00052 

00054 

00055 

00056 

00057 

00058 

00059 

00060 

00061 

00062 

00062 

00064 

001065 

00066 

0006?' 

010068 

01010^69 

000708 flBCD 
00071 

001072R RBCD 
R RBCD 


ENDC 

. CCtlJNT SET S0 . INITIRL VRUJE OF COUNTEF^ 

IFGE . COUNT-7 

. COUNT SET . COUNT-7 . REDUCE BV SEVEN 
RPT1_7 7 > <\±> . DO 7 LINES 
ENDC 

IFGE . COUNT-7 

. COUNT SET . COUNT-7 . REDUCE BV SEVEN MORE <14> 
RPT1_7 7.. <\ 1 > . DO 7 LINES 
ENDC 

IFGE . COUNT-7 

. COUNT SET . COUNT-7 . REDUCE BV SEVEN MORE <21> 
RPT1_7 7.. <S1> . DO 7 LINES 
ENDC 

IFGE . COUNT-7 

. COUNT SET . COUNT-7 . REDUCE BV SEVEN MORE <28> 
RPT1_7 7.. <S1> . DO 7 LINES 
ENDC 

IFGE . COUNT-7 

. COUNT SET . COUNT-7 . REDUCE BV SEVEN MORE <25;) 
RPT1_7 7.. CSl!) . DO 7 LINES 
ENDC 

RPT1_7 . COUNT.. <\1> DO REMRINING LINES 

OPT MEX 

ENDM 

+ INNER MRCRO—RECURSIVE 

RPT1_7 MRCR 
. T SET S0 
OPT MEX 
SI 

OPT NOMEX 
. T SET . T-1 
IFNE . T 

RPT1_7 . T.. CM!) 

ENDC 

ENDM 

•+ USE MRCRO TO GENERRTE TRBLE OF THE POWERS OF 

* TWO. THE TRBLE CRN BE LOCRTED RNVWHERE 

* SINCE THE EXPRESSION SUBTRRCTS THE PROGRRM 
COUNTER FROM THE BRSE RDDRESS OF THE TRBLE. 

ORG TRBCD ILLUSTRRTE INDEPENDENCE 

BRSE REPERT 16.. < FDB 2 ! - < < +-BRSE /2!).) 

OPT MEX 

0001 R FDB 2!-<<=k-BRSE;:'X2;) 
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OPT 

MEX 

A 

ABCF 

0002 

A 

FDB 

2!''<<*-BASE>/2> 





OPT 

MEX 

A 

ABDi 

0004 

A 

FDB 

2!^<:<*-BASE>X2> 





OPT 

MEX 

A 

ABDK 

0008 

A 

FDB 

2!''<:<’t'-BASE>/2) 





OPT 

MEX 

A 

ABD5 

0010 

A 

FDB 

2!''<:<*-BASE>/2) 





OPT 

MEX 

A 

ABD7 

0020 

A 

FDB 

2!'‘<<*-BASEV2> 





OPT 

MEX 

A 

ABD9 

0040 

A 

FDB 

2!^<<>*‘-BASE>X2) 





OPT 

MEX 

A 

ABDB 

0080 

A 

FDB 

2!-<<>f!-BASE>/2> 





OPT 

MEX 

A 

ABDD 

0100 

A 

FDB 

2!''<<*-BASEV2> 





OPT 

MEX 

A 

ABDF 

0200 

A 

FDB 

2!-<<:+-base;)X2) 





OPT 

MEX 

A 

ABEl 

0400 

A 

FDB 

2!^<<*-BASE>/2> 





OPT 

MEX 

A 

ABE2 

0800 

A 

FDB 

2!-<<*-baSE>/2> 





OPT 

MEX 

A 

ABE5 

1000 

A 

FDB 

2!'-c:<>t=-BASE;}/2> 





OPT 

MEX 

A 

ABE7 

2000 

A 

FDB 

2!"<<+-BASE>/2> 





OPT 

MEX 

A 

ABE9 

4000 

A 

FDB 

2r<(:*-BASE>/2> 





OPT 

MEX 

A 

ABEB 

8000 

A 

FDB 

2!''<<+-BASE>/2> 





OPT 

MEX 


0£i072 

00074 

00075 

00076 

00077 

00078fi 

fl 

fl 

FI 

Fl 


FIBED 
ABED 47 
RBEE 47 
ABEF 47 
ABF0 47 


* USE MACRO TO GENERATE VARIABLE NUMBER OF 
=+= SHIFT INSTRUCTIONS 

0005 A VI EQU 5 

REPEAT VI,<ASRA> 

OPT MEX 


A ABFl 47 

00079 

TOTAL ERRORS 00000—00000 


ASRA 

OPT 

ASRA 

OPT 

ASRA 

OPT 

ASRA 

OPT 

ASRA 

OPT 

END 


MEX 

MEX 

MEX 

MEX 

MEX 
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APPENDIX A 


CHARACTER SET 


The character set recognized by the Macro Assembler is a subset of ASCII. 

The ASCII code is shown in the following figure. The following characters 
are recognized by the Assembler: 

1. The upper case letters A through Z. 

2. The digits 0 through 9. 

3. Four arithmetic operators: +, *, and /. 

4. The special two-character operators: 1", 1>, 1<, IX, 1., 1+, IR, and IL. 

5. Parentheses in expression: (, ). 

6. The special symbol characters: underscore (_), period (.), and 
dollar sign ($). Only the period may be used as the first character 
of a symbol. 

7. The characters used as prefixes for constants and addressing modes: 

# Immediate addressing 

$ Hexadecimal constant 

& Decimal constant 
@ Octal constant 
% Binary constant 
^ ASCII character constant 

8. The characters used as suffixes for constants and addressing modes: 

,X Indexed addressing 

H Hexadecimal constant 

0 Octal constant 

0 Octal constant 

B Binary constant 

,PCR M6809 indexed addressing 

,S M6809 indexed addressing 

,U M6809 indexed addressing 

,Y M6809 indexed addressing 

9. Three separator characters: space, carriage return, and comma. 

10. The character to indicate comments. Comments may contain any 
printable characters from the ASCII set. 

11. The special symbols "\" and "\." used with the macro definitions as 
argument pointers or Assembler-generated symbols, respectively. 

12. For the M6800/M6801 and M6809 Macro Assemblers, the special symbols 
"A" and "B" to specify the accumulator in the operation code. For the 
M6805 Macro Assembler, the special symbols "A" and "X" to specify the 
accumulator or index register in the operation code. The special 
symbol "X" to indicate indexed addressing in the operand field; the 
special symbol "*" to represent the value of the current program 
counter; and the special symbol "NARG" to represent the number of 
macro arguments passed to the current level of macro expansion. For 
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the M6809 Macro Assembler, the special symbols "PCR", "S", "U", 
and "Y" to indicate indexed addressing in the operand field; the 
special symbol "D" to specify the accumulator in the operation code; 
the special symbols "A", "B", "CC", "D", "DP", "PC", "S", "U", "X", 
and "Y" to indicate registers in the operand field of the TFR, EXG, 
PSflU, PULU, PSHS, and PULS instructions; and the special symbols "A", 
"B", and "D" to indicate offsets in the indexed mode. 

13. For the M6809 Macro Assembler, the characters used to indicate 
indirect addressing; [, ]. 

14. For the M6809 Macro Assembler, the character "<" preceding an 
expression to indicate direct addressing mode or 8-bit offset in 
indexed mode, and the character ">" preceding an expression to 
indicate extended addressing mode or 16-bit offset in indexed mode. 

15. For the M6809 Macro Assembler, the characters used to indicate auto 
increment and auto decrement in the indexed mode: +, ++, -, --. 


ASCII CHARACTER CODES 


4 to 6 

-- 

0 

1 

2 

3 

4 

5 

6 

7 


0 

NUL 

DLE 

SP 

0 

@ 

P 

- 

P 

B 

1 

SOH 

DCl 

! 

1 

A 

Q 

a 

q 

I 

2 

STX 

DC 2 

II 

2 

B 

R 

b 

r 

T 

3 

ETX 

DC3 

# 

3 

C 

S 

c 

s 

S 

4 

EOT 

DC4 

$ 

4 

D 

T 

d 

t 


5 

EMQ 

NAK 

% 

5 

E 

U 

e 

u 

0 

6 

ACK 

SYN 

& 

6 

F 

V 

f 

V 


7 

BEL 

ETB 


7 

G 

W 

g 

w 

T 

8 

BS 

CAN 

( 

8 

H 

X 

h 

X 

0 

9 

HT 

EM 

) 

9 

I 

Y 

i 

y 


A 

LF 

SUB 

* 

; 

J 

Z 

j 

z 

3 

B 

VT 

ESC 

+ 

> 

K 

[ 

k 

{ 


C 

FF 

FS 

5 

< 

L 

\ 

1 

1 

1 


D 

CR 

GS 

- 

= 

M 

] 

m 

} 


E 

SO 

RS 

, 

> 

N 


n 

~ 


F 

SI 

US 

/ 

? 

0 


0 

DEL 
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APPENDIX B 


SUMMARY OF INSTRUCTIONS 


The following table lists the special symbols used in the description of 
M6800, M6801, M6805, and M6809 instructions. 

Operation Functions 


= Left side of equal sign is replaced by right side of equal sign 
t] Evaluate contents first; grouping 
() The contents of 

M() The contents of memory specified by the parenthetical address 
+ Arithmetic addition 

Arithmetic subtraction 
* Arithmetic multiplication 

and Boolean and 

effad M6809 effective address 

or Boolean inclusive or 

xor Boolean exclusive or 

L> Logical shift right by number of bits specified 

L< Logical shift left by number of bits specified 
A> Arithmetic shift right by number of bits specified 
A< Arithmetic shift left by number of bits specified 
R> Rotate right by number of bits specified 

R< Rotate left by number of bits specified 


Operand Sizes and Register Names 

$nn The hexadecimal number "nn" 

n A bit value of n (0 or 1) 

nn An eight-bit value of nn (00-$FF) 

nnnn A sixteen-bit value of nnnn (0000-$FFFF) 
aa Eight-bit address 

aaaa Sixteen-bit address 

A Accumulator A 

B M6800/M6801/M6809 Accumulator B 

C Carry condition code (Bit 0 of CC) 

CC Condition code register 

D M6801/M6809 dual accumulator A,B 

El M6805 external interrupt pin 

F M6809 fast interrupt condition code (Bit 6 of CC) 

H Half carry condition code (Bit 5 of CC; bit 4 if M6805) 

I Interrupt condition code (Bit 4 of CC; bit 3 if M6805) 

ii Eight-bit immediate operand 

iiii Sixteen-bit immediate operand 

N Sign condition code (Bit 3 of CC; bit 2 if M6805) 

P Program counter register 

rl M6809 register list 

rr Eight-bit, relative branch address 

rrrr Sixteen bit, relative branch address 
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S stack register 

U M6809 user stack register 

V M6800/M6801/M6809 overflow condition code (Bit 1 of CC) 

X Index register 

XX Eight-bit, indexed addressing offset 

xxop M6809 indexed operation depends on index mode (see B.5) 

xxO M6805 no offset indexed addressing 

xxl M6805 eight-bit, indexed addressing offset 

xx2 M6805 sixteen-bit, indexed addressing offset 

Y M6809 index register 

Z Zero condition code (Bit 2 of CC; bit 1 if M6805) 


Condition code symbols 

T Status bit tested and set if true; reset otherwise 
0 Status bit reset by operation 
1 Status bit set by operation 

Status bit unaffected by operation 
? Programming Reference Manual contains details on setting of 
the status bit 

B.l M6800 INSTRUCTIONS 

In the following tables, the "Function" column for branch instructions only 
contains the test condition performed by the branch. The following function 
will be performed if the result of the test is true: 

P=(P)+0002+rr 

If the result of the test is false, the following function will be performed: 

P=(P)+0002 

The functions for the instructions BSR, DAA, JSR, RTI, RTS, SWI, and WAI are 
described in detail in the M6800 Programming Reference Manual. 
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M6800 Instructions 


Mne¬ 

monic 

Oper¬ 

and 

Op¬ 

code 

Function 

H 

Status 
I N Z 

1 

V 

c 

ABA 


IB 

A=(A)+(8) 

T 


T 

T 

T 

T 

AUCA 

ii 

89 

A=(A)+ii+(C) 

T 

- 

T 

T 

T 

T 


aa 

99 

A=(A)+ M(aa)+(C) 








XX 

A9 

A*(A)+M.((X)+xx) + (C) 








aaaa 

B9 

A®( A)+M(aaaa) + (C) 







ADCB 

ii 

C9 

B=(B)+ii+(C) 

T 

- 

T 

T 

T 

T 


aa 

D9 

B=(B)+M(aa)+(C) 








XX 

E9 

B=(B)+M((X)+xx)+(C) 








aaaa 

F9 

B=(B)+M(aaaa)+(C) 







ADUA 

ii 

8B 

A=(A)+ii 

T 

- 

T 

T 

T 

T 


aa 

9B 

A=(A)+M(aa) 








XX 

AB 

A=(A)+M((X)+xx) 








aaaa 

BB 

A=(A)+M(aaaa) 







ADUB 

ii 

CB 

B=(B)+ii 

T 

- 

T 

T 

T 

T 


aa 

UB 

B=(B)+M(aa) 








XX 

E8 

B=(B)+M((X)+xx) 








aaaa 

FB 

B=(B)+M(aaaa) 







ANDA 

ii 

84 

A=(A) and ii 

- 

- 

T 

T 

0 

- 


aa 

94 

A=(A) and M(aa) 








XX 

A4 

A=(A) and M((X)+xx) 








aaaa 

B4 

A=(A) and M(aaaa) 







ANDB 

ii 

C4 

B=(B) and ii 

- 

- 

T 

T 

0 

- 


aa 

D4 

B=(B) and M(aa) 








XX 

E4 

B=(B) and M((X)+xx) 








aaaa 

F4 

B=(B) and M(aaaa) 







ASL 

XX 

68 

M((X)+xx)=M((X)+XX) A< 1 

- 

- 

r 

T 

? 

r 


aaaa 

78 

M(aaaa)=M(aaaa) A< 1 







ASLA 

— 

48 

A=(A) A< I 

- 

- 

T 

T 

? 

r 

ASLB 

—- 

58 

B=(B) A< 1 

- 

- 

T 

T 

? 

r 

ASR 

XX 

67 

M((X)+xx)=M((X)+XX) A> 1 

- 

- 

T 

T 

? 

r 


aaaa 

77 

M( aaaa ) = M( aaaa) A> 1 







ASHA 

— 

47 

A=(A) A> 1 

- 

- 

T 

T 

? 

T 

ASRB 

— 

57 

B=(B) A> 1 

- 

- 

T 

T 

? 

T 

8CC 

rr 

24 

Test (C)=0 

- 

- 

- 

- 

- 

- 

BCS 

rr 

25 

Test (C)=l 

- 

- 

- 

- 

- 

- 

BEQ 

rr 

27 

Test (Z)=l 

- 

- 

- 

- 

- 

- 

BGE 

rr 

2C 

Test (N) xor (\/)=0 

— 

- 

- 

- 

- 

— 

BGT 

rr 

2E 

Test (Z) or KN) xor (V)]=0 

- 

- 

- 

- 

- 

- 

BHI 

rr 

22 

Test (C) xor (Z)=0 

- 

- 

— 

- 

- 

- 

BITA 

ii 

85 

(A) and ii 

- 

- 

T 

T 

0 

- 


aa 

95 

(A) and M(aa) 








XX 

A5 

(A) and M((X)+xx) 








aaaa 

B5 

(A) and M(aaaa) 







BITB 

ii 

C5 

(B) and ii 

- 

- 

T 

T 

0 

- 


aa 

U5 

(B) and M(aa) 








XX 

E5 

(B) and M((X)+xx) 








aaaa 

F5 

(B) and M(aaaa) 







BLE 

rr 

2F 

Test (Z) or KN) xor (V)] = l 

- 

- 

- 

- 

- 

- 

BLS 

rr 

23 

Test (C) or (Z)=l 

— 

- 

— 

— 

- 

- 

BLT 

rr 

2D 

Test (N) xor (V)=l 

— 

- 

— 

• 

— 

- 
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M6800 Instructions 


Mne¬ 

Oper¬ 

Op¬ 

Function 

Status 

monic 

and 

code 


H I N Z V C 


BMI 

rr 

2B 

Test (N) = l 

- 

- 

- 

- 

- 

- 

BNE 

rr 

26 

Test (Z)=0 

- 

- 

- 

- 

- 

- 

BPL 

rr 

2A 

Test (N)=0 

- 

- 

- 

- 

- 

- 

BRA 

rr 

20 

Tests always true 

- 


- 

- 

- 

- 

BSH 

rr 

8D 

Subroutine call 

- 

- 

• 

- 

- 

- 

BVC 

rr 

28 

Test (V)=0 

- 

- 

— 

- 

- 

- 

BVS 

rr 

29 

Test (V)=l 

- 

- 

- 

- 

— 

- 

CBA 

— 

11 

(A)-(B) 

— 

- 

T 

T 

T 

T 

CLC 

—- 

OC 

C=0 

— 

- 

— 

- 

- 

0 

CL I 

— 

OE 

1=0 

- 

0 

— 

- 

— 

— 

CLR 

XX 

6F 

M((X)+xx)=00 

- 

- 

0 

1 

0 

0 


aaaa 

7F 

M(aaaa)=00 







CLHA 

— 

4F 

A=00 

- 

- 

0 

1 

0 

0 

CLRB 

— 

5F 

B=00 

- 

- 

0 

1 

0 

0 

CLV 

— 

OA 

V=0 

- 

- 

- 


0 

- 

CMPA 

11 

81 

(A)-ll 

- 

- 

T 

T 

T 

T 


aa 

91 

(A)-M(aa) 








XX 

Al 

(A)-M{(X)+xx) 








aaaa 

Bl 

(A)-M(aaaa) 







CMFB 

11 

Cl 

(B)-ll 

- 

- 

T 

T 

T 

T 


aa 

D1 

(B)-M(aa) 








XX 

El 

(B)-M((X)+xx) 








aaaa 

FI 

(B)-M(aaaa) 







COM 

XX 

63 

M((X)+xx)=M((X)+xx) 

xor $FF - 

- 

T 

T 

0 

1 


aaaa 

73 

M(aaaa)»M(aaaa) xor 

$FF 






COMA 

— 

43 

A=(A) xor $FF 

- 

- 

T 

T 

0 

1 

COMB 

— 

53 

B=(B) xor $FF 

- 

- 

T 

T 

0 

1 

CPX 

ilii 

8C 

(X)-llll 

- 

- 

? 

T 

? 

- 


aa 

9C 

(X)-M(aa,aa+1) 








XX 

AC 

(X)-M((X)+xx,(X)+xx+l) 







aaaa 

BC 

(X)-M(aaaa,aaaa+l) 







DAA 


19 

Converts binary add 
BCD Into BCD 

of 

•• 

T 

T 

T 

? 

DEC 

XX 

6A 

M((X) + xx)=M((X)+xx)- 

-01 

- 

T 

T 

? 

- 


aaaa 

7A 

M(aaaa)=M(aaaa)-01 







DECA 

— 

4A 

A=<A)-0I 

- 

- 

T 

T 

? 

- 

DECB 


5A 

B=(B)-01 

- 

- 

T 

T 

? 


DES 

— 

34 

S=(S)-0001 

- 

- 

— 

- 

- 

- 

DEX 


09 

X=(X)-000l 

- 

- 

- 

T 

- 

— 

EORA 

11 

88 

A=(A) xor 11 

- 

- 

T 

T 

0 

- 


aa 

98 

A=(A) xor M(aa) 








XX 

A8 

A=(A) xor M((X)+xx) 








aaaa 

B8 

A=( A) xor M(aaaa) 







EORB 

11 

C8 

B=(B) xor 11 

- 

- 

T 

T 

0 

- 


aa 

08 

B=(B) xor M(aa) 








XX 

E8 

B=(B) xor M((X)+xx) 








aaaa 

F8 

B=(8) xor M(aaaa) 







INC 

XX 

6C 

M((X)+xx)=M,((X)+xx)+OI 

- 

T 

T 

? 

- 


aaaa 

7C 

M(aaaa)=M(aaaa)+01 







INCA 


4C 

A=(A)+0l 

- 


T 

T 

? 

- 


B-4 













M6800 Instructions 


Mne¬ 

monic 

Oper¬ 

and 

Op¬ 

code 

Function 


H 

Status 

I N Z V 

c 

INCB 


5C 

B=(B)+0I 




T 

T 

? 


INS 


31 

S=(S)+000l 


- 

- 

— 

— 


- 

I NX 

-- 

08 

X=(X)+0001 


- 

- 

- 

T 

- 

- 

JMP 

XX 

6E 

P=(X) + xx 


- 

- 

- 

- 

- 

- 


aaaa 

7E 

P=aaaa 








JSH 

XX 

AD 

Subroutine call 


— 

- 

- 


- 

- 


aaaa 

BD 

Subroutine call 








LDAA 

ii 

86 

A=li 


— 

- 

T 

T 

0 

— 


aa 

96 

A=M(aa) 









XX 

A6 

A=M((X)+xx) 









aaaa 

B6 

A=M(aaaa) 








LDAB 

ii 

C6 

B=ii 


- 

- 

T 

T 

0 

— 


aa 

D6 

B=M(aa) 









XX 

E6 

B=M((X)+xx) 









aaaa 

F6 

B=M(aaaa) 








LDS 

iili 

8E 

S=ilii 


- 

- 

? 

T 

0 

- 


aa 

9E 

S=M(aa«aa+1) 









XX 

AE 

S=M((X)+xx,(X)+xx+l) 









aaaa 

BE 

S=M(aaaa,aaaa+1) 








LDX 

llii 

CE 

X=iiii 


- 

— 

? 

T 

0 



aa 

DE 

X=M(aa,aa+l) 









XX 

EE 

X=M((X)+xx,(X)+xx+1) 









aaaa 

FE 

X=M(aaaa,aaaa+l) 








LSR 

XX 

64 

M((X.) + xx)=M((X)+xx) 

L> 1 

- 

- 

0 

T 

? 

T 


aaaa 

74 

M(aaaa)=M(aaaa) L> I 








LSrtA 

— 

44 

A=(A) L> 1 


- 

- 

0 

T 

? 

r 

LSHB 

— 

54 

B=(B) L> I 


— 

- 

0 

T 

? 

T 

NEG 

XX 

60 

M({X)+xx)=00-M((X)+xx) 

— 

- 

T 

r 

? 

? 


aaaa 

70 

M(aaaa)=00-M(aaaa) 








NEGA 

— 

40 

A=00-(A) 


— 

— 

T 

T 

? 

? 

NEGB 

— 

50 

8=00-(B) 


— 

— 

T 

T 

? 

? 

NOP 

— 

01 

P=(P)+0001 


— 

• 

— 

— 


— 

ORAA 

ii 

8A 

A= (A) or i i 



— 

T 

T 

0 



aa 

9A 

A=(A) or M(aa) 









XX 

AA 

A=(A) or M((X)+xx) 









aaaa 

BA 

A=(A) or M(aaaa) 








GRAB 

ii 

CA 

B=(B) or ii 


— 

— 

T 

T 

0 

— 


aa 

UA 

B=(B) or M(aa) 









XX 

EA 

B=(B) or M((X)+xx) 









aaaa 

FA 

B=(B) or M(aaaa) 








PSHA 

— 

36 

M(S)=A» S=(S)-000l 


— 

— 

— 

- 

— 

— 

PSHB 

— 

37 

M(S)=B» S=(S)-000l 


— 

— 

— 

— 


— 

PULA 

— 

32 

S=(S)+0001; A=M(S) 


— 

<* 

-i 

— 


«. 

PULB 

— 

33 

S=(S)+0001; B=M(S) 


— 

— 

— 

— 


— 

ROL 

XX 

69 

M((X)+xx)=M((X)+xx) 

R< 1 


— 

T 

T 

? 

T 


aaaa 

79 

M(aaaa)=M(aaaa) R< 1 








ROLA 

— 

49 

A=(A) H< 1 




r 

T 

? 

T 

ROLB 

— 

59 

B=<B) R< 1 


— 

— 

T 

T 

? 

r 

ROR 

XX 

66 

M((X)+xx)=M({X)+xx) 

R> 1 

— 

— 

T 

T 

? 

T 


aaaa 

76 

M( aaaa)=M(aaaa ) R> 1 
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M6800 Instructions 


Mne¬ 

monic 

Oper¬ 

and 

Op¬ 

code 

Function 

H 

Status 
I N Z 

V 

c 

ROHA 


46 

A={A) R> 1 



T 

T 

? 

T 

ROHB 

— 

56 

B=(B) R> 1 

- 

• 

T 

T 

? 

T 

RTI 

— 

3B 

Return from Interrupt 

i 

? 

? 

? 

? 

? 

RTS 

— 

39 

Return from subroutine 

- 

- 

• 

- 

- 

- 

SBA 

— 

10 

A=(A)-(B) 

- 

- 

T 

T 

T 

T 

SBC A 

ii 

82 

A=(A)-ii-(C) 

- 

- 

T 

T 

T 

r 


aa 

92 

A=(A)-M(aa)-(C) 








XX 

A2 

A=(A)-M((X)+xx)-(C) 








aaaa 

B2 

A=(A)-M(aaaa)-(C) 







SBCB 

ii 

C2 

B=(B)-li-(C) 

- 

- 

T 

T 

T 

T 


aa 

U2 

B=(B)-M(aa)-(C) 








XX 

E2 

B=(B)-M((X)+xx)-(C) 








aaaa 

F2 

B=(B)-M(aaaa)-(C) 







SEC 

— 

OD 

C=l 

- 

- 

- 

- 

- 

1 

SEI 


OF 

1=1 

- 

1 

- 

- 

- 

- 

SEV 

— 

OB 

V=l 

- 

- 

- 

- 

1 

- 

ST A A 

aa 

97 

M( aa) = (A) 

- 

- 

T 

T 

0 

- 


XX 

A7 

M((X)+xx)=(A) 








aaaa 

B7 

M(aaaa)=(A) 







STAB 

aa 

07 

M(aa)=(B) 

• 

- 

T 

T 

0 

- 


XX 

E7 

M((X)+xx)=(B) 








aaaa 

F7 

M(aaaa)=(B) 







STS 

aa 

9F 

M(aa»aa+l)=(S) 

- 

- 

7 

T 

0 

- 


XX 

AF 

M((X)+xx,(X)+xx+l)=(S) 








aaaa 

BF 

M(aaaa,aaaa+1)=(S) 







STX 

aa 

OF 

M(aa,aa+l)=(X) 

- 

- 

? 

T 

0 



XX 

EF 

M((X)+xx,(X)+xx+l)=(X) 








aaaa 

FF 

M(aaaa,aaaa+1)=(X) 







SUBA 

il 

80 

A=(A)-ii 

- 

- 

T 

T 

T 

T 


aa 

90 

A=(A)-M(aa) 








XX 

AO 

A=(A)-M((X)+xx) 








aaaa 

BO 

A=(A)-M(aaaa) 







SUBB 

ii 

CO 

B=(B)-ii 

- 

- 

T 

T 

T 

r 


aa 

DO 

B=(B)-M(aa) 








XX 

EO 

B=(B)-M((X)+xx) 








aaaa 

FO 

B=(B)-M(aaaa) 







SWI 

— 

3F 

Software interrupt 

- 

1 

- 

- 

- 

- 

TAB 

— 

16 

B=(A) 

- 

- 

T 

T 

0 

- 

TAR 


06 

CC=( A) 

? 

? 

? 

? 

? 

? 

TBA 

- - 

17 

A=(B) 

- 

- 

T 

T 

0 

- 

rPA 

— 

07 

A=( CO 

- 

- 

- 

- 

- 

- 

TSf 

XX 

60 

M((X)+xx)-00 

- 

- 

T 

T 

0 

0 


aaaa 

70 

M( aaaa)-00 







rSTA 

— 

40 

(A)-00 

- 

- 

T 

T 

0 

0 

TSTB 

— 

50 

(B)-OO 

- 

- 

T 

T 

0 

0 

TSX 

— 

30 

X=(S)+000I 

- 

- 

- 

- 

— 

- 

fXS 


35 

S*(X)-000I 

- 

- 

- 

- 

- 

- 

»^AI 


3E 

Wait for IRQ 

- 

? 

— 

— 

— 

- 
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B.2 M6801 INSTRUCTIONS 


The M6801 allows all of the instructions from the preceding table. In addition, 
the following instructions are valid. These instructions can only be assembled 
using the MOOS or tape version of the M6800 Macro Assembler. 


Mne¬ 

monic 

Oper¬ 

and 

Op¬ 

code 

Function 

H 

Status 
I N Z 

7 

C 

A.BX 


3A 

X=(X)+(B) 







ADDD 

iiii 

C3 

D=(D)+ilii 

- 

- 

T 

T 

T 

T 


aa 

D3 

D=(D)+M(aa,aa+1) 








XX 

E3 

D=(D)+M((X)+xx,(X)+xx+l) 








aaaa 

F3 

D=(D)+M(aaaa,aaaa+l) 







ASLD 


05 

D=(D) A< 1 

- 

- 

T 

T 

? 

T 

8HS 

rr 

24 

Test (0=0 

- 

- 

- 

— 

— 

- 

BLO 

rr 

25 

Test (0 = 1 

- 

- 

- 

- 

— 

- 

BHN 

rr 

21 

Tests always false 

- 

- 

- 

- 

- 

- 

JSH 

aa 

9D 

Subroutine call 

- 

- 

- 

- 

- 

- 

LDD 

iiii 

CC 

D=ilii 


- 

T 

T 

0 

- 


aa 

DC 

D=M(aa,aa+l) 








XX 

EC 

D=M((X)+xx,(X) +XX+ 1 ) 








aaaa 

FC 

D=M(aaaa,aaaa+1) 







LSL 

XX 

68 

M((X)+xx)=M((X)+xx) L< 1 

- 

- 

T 

T 

? 

T 


aaaa 

78 

M(aaaa)=M(aaaa) L< 1 







LSLA 

— 

48 

A=(A) L< 1 

- 

- 

T 

T 

? 

T 

LSLB 

— 

58 

B=(B) L< 1 

- 

- 

T 

T 

? 

T 

LSLD 

— 

05 

D=(D) A< 1 

- 

- 

T 

T 

? 

T 

LSrfD 


04 

D=(D) L> 1 

— 

- 

0 

T 

? 

T 

MUL 

-- 

3D 

D=(A)*(B) 

- 

- 

- 

- 

- 

? 

PSHX 

— 

3C 

M(S,S+I)=(X)» S=(S)-0002 

- 

- 

— 

- 

— 

— 

HULX 

— 

38 

S=(S)+0002; X=M(S,S+1) 

- 

- 

- 

- 

- 

- 

STD 

aa 

DD 

M(aa,aa+l)=(D) 

- 

- 

T 

T 

0 

— 


XX 

ED 

M((X)+xx.(X)+xx+l)=(D) 








aaaa 

FD 

M(aaaa,aaaa+l)=(D) 







SUBD 

iiii 

83 

D=(D)-liii 

- 

- 

T 

T 

T 

T 


aa 

93 

D=(D)-M(aa,aa+I) 








XX 

A3 

D=(D)-M((X)+xx,(X)+xx+l) 








aaaa 

B3 

D=( D)-M(aaaa,aaaa+1) 
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B.3 M6805 INSTRUCTIONS 


In the following tables, the "Function" column for branch instructions only 
contains the test condition performed by the branch. The following function 
will be performed if the result of the test is true: 

P=(P)+0002+rr (for branch) 

P=(P)+0003+rr (for bit test and branch) 

If the result of the test is false, the following function will be performed: 

P=(P)+0002 (for branch) 

P=(P)+0003 (for bit test and branch) 

The functions for the instructions BSR, JSR, RTI, RTS, STOP, SWI, and WAIT 
are described in detail in the M6805 Programming Reference Manual. 
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li n e- 
rnori i 


F u r i c. 1;. i o n 


Oper- Op- 

a n d c.«:««:l «=! 


Status 
H I M Z C 


ADC 

i i 

A9 

A=^( A) + ;i ;i + <C) 

r 

- r 

T 

T 


a a 

B9 

A-- (A) +M ( aa) + (C) 






aaaa 

C9 

A=^( A)+M( aaaa) + (C) 






X x2! 

D9 

A^- ( A)4M( (X) + ;<;<2)-KC) 






\# V/ 1 
\ / A .L 

S.9 

A-:^:(A) (X)4 x;.;.L ) i- (C) 






X xO 

F 9 

A"-(A)tl'1(X) + (C) 





ADD 

i i 

AB 

A=( A)+;l;l 

r 

... j- 

f 

T 


cl a 

BB 

A:--(A)+I'1(aa) 






aaaa 

CB 

A--^(A) UKaaaa) 






X x2 

DB 

A=--(A)+M( (X) + xx2) 






V/ 1 

/ \ / % X 

EB 

A-(A)+M<(X)+xxl ) 






X xO 

FB 

A^--( A) H M (X ) 





AMD 

i i 

A 4 

A”<A) and i i 

•- 

.... j- 

T 

- 


a <1 

B4 

A=-(A) and M(aa) 






aaaa 

C4 

A=: (A) a n d M ( a a a a) 






\ / 1 / • / 

/ % f\ 

D4 

A=--^(A) and M((X) + xx2) 






1 

/\ /\ .i 

E4 

A==<A) and M<(X)+xxl) 






'/O 

F4 

A^-(A) and M(X) 





ASL. 

a a 

3l--! 

M(aa)^^=M(aa) AC 1 

.... 

. 1* 

T 

T 


X X 1 

68 

M( (X) + xxl (X) A< 1 






V v(") 

/ V AV' 

78 

r-RXl^^^KX) AC .1 





ASIA 

— 

48 

A=-=(A) A< 1 


-- T 

F 

I 

ASLX 


58 

X-^(X) AC 1 


• r 

T 

T 

ASR 

a a 

37 

l'1(aa)^=M(aa) A> 1 


... "j 

T 

T 


1 

f\ f\ X 

67 

M< < X ) +;.;xl ) ( ( X ) +;.;k1 ) AI 

> 1 





V */0 

77 

M(X):-^I'1(X) A> I 





ASRA 

— 

47 

A==<A) A> 1 

- 

.... f 

T 

T 

ASRX 

— 

57 

X^--(X) A> 1 

- 

.... J 

T 

T 

BCC 

1 * r 

24 

Test (0^0 



.... 


BCL.R 

tj; a a 

J. i 

Bit 0 of M(aa)“0 

- 

.... .... 

... 



1; a a 

.13 

Bit 1 of M<aa)-x:) 






7j a a 

15 

Bit 2 of l'1(aa)=^=0 






3^ aa 

17 

1311 3 of M(aa)"0 






4. a a 

19 

Bit 4 of l'1(aa):-0 






5; a a 

IB 

Bit 5 of M(aa)=0 






4’*a <1 

ID 

Bit 6 of M(aa)=^0 






/t aa 

IF 

Bit 7 of M<.aa) =0 





DCS 

r r 

25 

Tost (C)“-i 

.... 


... 


BRQ 

f" r 

27 

Test (Z)^^l 


. 



i;:!i-n;:c 

r r 

‘*^5-1 

Test (H)^=0 

.... 

. 



BHCS 

r r- 

29 

Test (H)--=l 



.... 

... 


r r 

.y 

lest (C) xor (2)=-^:) 

. 

. 

.... 

... 

BHS 

r r 

24 

Test (C-l-^x;) 



... 


BJ.il 

r r 

7F" 

Tost FI =-^hi.nh 

... 

. 



BIL 

r r 

2E 

Test El “.low 

.... 

. 

.... 

... 
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line-- 



Op- 

F u r‘i c 

t i o n 




•D 

tat 

u 

s 


m o n :i c. 


, . 

0. C* d J:! 

M.,t ..... r.M. ... I.... 



.. . 

.. 1 1 ,, . 

H 

I 

N 

z 

C 

BIT 

i i 


A5 

<A) 

a n cl i i 






T 

T 

.... 


a a 


B5 

(A) 

it r 1 d li ( s 

a) 









aaaa 


C5 

(A) 

and M(a 

a a a 

) 










DO 

(A) 

and li( ( 

X) + 

X k2 ) 








i 

/% /\ 4* 


E5 

(A) 

and M<< 

X) 

X X 1 ) 








K kO 


FO 

(A) 

and li(X 

) 








Bl .0 

rr 


25 

Test. 

(C) 1 





... 

.... 

- 

... 

Bij-:; 

r r 


23 

Test 

(C) or 

(Z 

):r=i 


-- 

... 

... 

... 

... 

BMC 

r r 


2r: 

Test. 

(I) ==0 





•- 

- 

•- 

.... 

BN I 

r r 


;?B 

T est 

(N) 1 




-- 

- 

... 

... 

- 

BMS 

rr 


2D 

Test 

( I )^=:1 





... 

.... 

... 

.... 

BNt; 

r r 


26 

T s 1'.. 

( 1) :"-0 




- 

- 

... 

. 

... 

BPl. 

r r 


2A 

f «5 S t- 

(N) =^=0 




..... 

.... 

... 

.... 


BI-^A 

r r 


20 

1 ffSt 

s alujay 

s t 

!•“ L» C 



... 

... 

- 

•- 

BRCIJ^' 

Of aa> 

rr 

01 

Test 

bit 0 

«:«f 

M ( aa) •■ 

“0 


... 

- 

- 

r 


J. .• <i i 

r r 

03 

T est 

bit 1 

0 f 

M (ita) = 

“0 







2^ aa> 

J... J... 

05 

Test 

bit 2 

0 f 

M<aa) 

-0 







3/ aa^ 

r r 

07 

1 est 

bit 3 

0 f 

M(<-ia): 

=0 







4) a a, 

r r 

09 

Test 

bit 4 

0 f 

M( aa)- 

~0 







i a ci / 

r r 

OB 

Te-st 

bit 5 

of 

li(aa)^ 

=0 







6; aa/ 

rr 

OD 

Test 

bi t 6 

0 f 

ii < a -a) 

-0 







/a a / 

r r 

Of" 

I e s t 

bit 7 

0 f 

M( aa)^ 

-0 






BRM 

r r 


21 

Test 

s alway 

s f 

al se 




.... 


... 

BR::;;E'r 

tJ / a ci / 

r r 

00 

1 e s t 

b i t 0 

0 f 

li(aa)^ 

-1 

.... 

... 

.... 

... 

- 


if aa; 

rr 

02 

Test 

bit 1 

of 

M< aa) = 

"1 







2; a a; 

r r 

04 

Test 

1:. i t 2 

of 

M(aa)^ 

==1 







3; a a; 

rr 

06 

Test 

bit 3 

0 f 

M<aa) • 

•^1 







Af a a; 

r r 

08 

Test 

bit 4 

0 f 

ii ( a a): 

■i. 







5; aa; 

rr 

OA 

T" e s t 

bi t 5 

f 

M < -a a) ■ 

-■1 







6; aa; 

r r 

oc 

Test 

bit 6 

0 f 

li(aa)^ 

-1 







7; aa; 

r r 

OE 

Test 

bit 7 

«:i f 

M (-a.a) 

^ 1 






BSET 

; a a 


10 

B11 

0 of ii( 

aa) 

^-1 


.... 

... 

- 

... 

... 


1; a a 


12 

B :i t 

1 of M( 

a a) 









2; a a 


14 

Bit 

2 o f li ( 

a a) 

.•r. j. 








3; aa 


16 

Bit 

of M< 

aa) 

^1 








; a -a 


18 

Bit 

4 of li( 

a ci) 

•••^- 1 








5; a a 


lA 

Bi t. 

5 of i'K 

a a) 

: 1 








6 :*; a CJ 


1C 

B i t 

6 of li( 

a ca ) 

1 








7; a a 


1E 

Bi t 

7 of M< 

a a) 

^ ^ 1 







BSR 

!* r 


AD 

8. u b f 

< ■ I. .I t i n e 

cal 

1 


-- 



.... 

... 

CI..C 

. 


Q0 

C-"0 





.... 



•- 

0 

Cl.T 

—• 


9A 

I -0 





..... 

0 

... 

... 


Cl-R 

a a 


3F 

M ^ s 

) ••00 






0 

1 



r% f\ J. 


6F 

M ( ( X 

) -1- K K 1 ) 

00 









/\ /•.V.' 


7F 

M( X) 

~"00 









i: ;i. RA 



4F 

A=00 




.... 

... 

0 

J. 


Ci.RX 



5F 

X--00 







0 

1 

.... 
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Mne- 

C.I f:« e r- 

Op- 

F " u r 1 1;. i ci r i 




S t a 1;. u 

"> 


rn 0 n i c. 

and 

C. 0 cl Cf 

. ....... 

_____ 

.. 

_____ 

II 1 IM 

1 

c 

CMP/ 

i :i 

A.l 

(A).ii 




. r 

r 

1' 

CMPA 

a a 

Bi 

(A) -M (.;> a ) 








aaaa 

C ,l 

(A) -Mlaaaa 

) 







V y/'y 

i:i I 

(A) - M ( ( X ) 4 

xx?) 







i 

/% ,*% *l 

El 

(A)-M((X)+ 

XX 1 ) 







K '<0 

f I. 

( A ) •• M ( X ) 







COM 

■a 

33 

M(aa)-^M(aa 

) xor '$E 

■f" 


•. 1' 

i‘ 

.1 


4\ f\ J. 

63 

M ( ( X ) 1 ! •! K 5. ) 

■■- n ((X) 4! 

X 1 ) 

K Cl L ^l>F 1' 





vf) 

/x f X y*' 

73 

M(X)--^ M(X) 

xor 1;Ff 






i;:OMA 


43 

A^ (A) Kor 

f 



.. r 

V 

i 

COMX 

. 


X^^3X) xor 

‘Wf 



. f 

T 

.1 

CPX/ 

i i 

A3 

( X ) - i. i 




. T 

T 

1 

CMPX 

a. a 

B3 

( X ) -M ( a.a) 








a **5 a -'i 

03 

(X)-M(aaaa 

) 







K >( 2 

D3 

( X ) ■ M < ( X ) :• 

xx2) 







KXi 

E3 

(X)“M( (X) + 

X X j. ) 







xO 

F3 

(X)-M(X) 







Ok-C 

a a 

3A 

M(aa)^-44(aa 

) -01 



. T 

J 

. 


\ / \/ i 

6A 

M(<X)+xxl) 

-M(<X)+; 

.;xl ) 

-0.1 





X )<0 

7 A 

M ( X ) - M ( X ) -• 

OJ. 






Dt'CA 


4 A 

A --^3 A)-01 




- . r 

.... 

- 

!:iFi:::x/ 

— 

OA 

yx^^(X)-01 




-.- 1 

■] 

.... 

DPX 










E OP 

3. i 

A3 

A- (A) X 0 r 

i i. 



. \ 

T 

. 


a a 

138 

A^MA) xor 

M( aa) 







c‘; a a ci 

CkJ 

A:= (A) xor 

M (ii a a a ) 







' / \f ''y 

t\ •«. 

D8 

A=^3A) xor 

MC (X) 4 X!. 

;2) 






xxi 

F3 

A"- (A) X ti r 

M ( ( X ) 4 X; 

•:j. ) 






X xO 

FS 

A^^(A) xor 

M< X) 






1 NC 

a a 

3C 

M(aa)^-^44(aa 

) +01. 



- T 

■f 

... 


\/ •-/ i 

•• V t\ t 

6C 

M( ( X ) t-xx! ) 

-4'l( (X) 4-; 

;xl ) 

+01 





X xO 

7C 

M ( X ) :^=M ( X ) +0 i 






INCA 

......... 

4C 

A -3 A)+01 




... -... j- 

r 

- 

INCX/ 

........ 

5C 

X = -(X)+Oi 




- T 

T 


IMX 










..IMP 

a a 

BC 

F"'" “ a ci 




-.. 


- 


a a a a 

CC 

F'~* a a a a 








X x2! 

DC 

P:--(X>+XX2 








\/ V I 

/ V / \ X 

EC 

p“< X)i xx l 









FC 

P-. ( X ) 







.ISR 

a a 

BD 

Sf. «..i b Cl u 1;. 3. r‘i c 

oal. 1 



.. 

- 

- 


aaaa 

CD 

S M b r 01 . 1 1 i n o 

I'.a'l 1 







xx2 

DB 

!..i t:i r* o u 11 ri c. 

call 







X X .1 

ED 

S »j b I- 0 ».i t. i n cj 

I-', a 1 '.1 







X xO 

FD 

LI t:» V 0 LI 13. ft C 

ca). ]. 
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M n G- 
fn o n i 0. 


F u n (! t j. o n 


0 p G r- 0 p- 
n d c. o d '5 


Status 
H I N Z C 


LDA 

i i 

A6 

A-::i:i 



.... 

“■ T 

T 

.... 


a a 

B6 

A=-M(aa) 








aaaa 

C6 

A“M< aaaa) 








V 

fs 

D6 

A“M( (X) + ;<;<2) 








V/ V/ t 

/ \ t\ .I* 

E6 

A-M< <X) f-KX.1 ) 








;< kO 

f6 

A=^--M ( X ) 







I...DX 

i :i 

AE 

X“i i 



- 

.... I* 

T 

-• 


a a 

BE 

X=^-M(aa) 








aaaa 

CE 

X "fK aaaa) 









DE 

X=--M( (X) + xk2) 








V 1 
/ % JL 

EE 

X“M( <X)+>;kI ) 








K ;:0 

FF 

X^-=M(X) 







1J51. 

a a 

.,^1 y 

M<aa)-:r'l<aa) AC .1 



- 

... f 

r 

T 


V K* 1 
i \ / % J« 

68 

MC (X) (X )•+;•;;<).) 

AC 

i 






\* V O 

78 

M(X)^^:M<X) AC .1 







LSLA 


48 

A=-(A) AC J. 



•• 

... 1 

T 

1 

I..SI..X 

— 

58 

X--^RX) AC 1 




• r 

T 

r 

Lsn 

a a 

34 

l.> ). 



... 

0 

T 

1 


V 1 

/ \ / *• «i 

64 

r'R <X)+K;;.l)-=r'l( ( X .1 ) 

l:> 

.1 






K kO 

74 

M(X)=-4'1(X) L> ). 







I-.SRA 

•— 

44 

A=^RA) l...> .1 




- 0 

T 

T 

LSRX 


54 

X=^=(X) l..< 1 



.... 

0 

V 

T 

MFG 

a a 

30 

M< aa)“00--M( aa) 




- I 

T 

r 


K K i 

60 

M ( ( X ) H x K i ) : -00- M ( ( X ) + K 

<i .) 







V v{ ) 

70 

M ( X ) ^-x:)0“-M ( X ) 







NFGA 


40 

A^-OO- (A) 



... 

~ T 

T 

T 

MF6X 

— 

SO 

X===00-~<X) 



. 

-- r 

T 

r 

NDf 

...... 

9D 

P- (F*) +000 i 



... 

. 

_.. 

... 

Of^A 

:L .1 

AA 

A“(A) or i ;i 



... 

• r 

T 



a \A 

BA 

A=--(A) or MCaa) 








aaaa 

CA 

A”RA> or M<aaaa) 









BA 

A=-(A) or M((X) + kk2) 








V 1 
/*. .*v JL 

EA 

A=<A) or rK (X)+x)M ) 








V vO 

FA 

A=- ( A ) 0 r M ( X ) 







ROI... 

a a 

39 

r'l(aa)---M( aa) RC 1 



.... 

.... f 

r 

T 


K K J. 

69 

M( (X) + K:<i )==H( (X) + K!<i ) 

RC 

J. 






V v( ’) 

A A V' 

79 

M(X)^^=M<X) RC .1 







ROLA 

— 

49 

A:rr.(A) RC i 



- 

- T 

T 

T 

ROLX 


59 

X=(X) RC 1 




■f 

T 

r 

ROR 

a a 

36 

M(aa) = --M(aa) R:> i 



- 

- T 

T 

T 


V V i 
/ > A .1 

66 

M< (X)+>!X.l )-^=M( <X)+xxl ) 

R> 

1 






vO 

A A\.‘ 

76 

M(X)=-^M(X) r;> i 







RQRA 


46 

A~(A) R> 1 



- 

.... I- 

f 

T 

RORX 

— 

56 

X=---(X) R> i 



... 

- T 

'1 

■| 

RSP 

— 

9C 

S^7F 



.... 

- - 

... 

... 

R T I 

— 

80 

R G t u r n f r o m i ti t g r r u p t 



? 


2 

2 

RTS 

—- 

8.1 

R >51M r n f r om s u b r o 11 1 i n i 



..... 

.-. ... 

... 

-- 


B-12 








M v\ e - 
rri c« n :l«?. 


F «. i n c t i Cl n 


Opef'-- Op- 

a ri «"l r. «:•«:! c; 


S t cl t u s 
H I M Z C 


SBC 

i :i 

A 2 

A-=(A)-ii-(C) 

. 

T 

T r 


a a 

P2 

(A)-M(r(C) 





a a a a 

C 2 

A=^:< A.>"-M< ii.^aa)-"(C) 





X x 2 

D 2 

A- (A) - I’K (X)-i k!<2) ■ (C) 





X X .1 

E 2 

A-^) A.) "M ( (X ) +>;>; 1 ) "(i.:) 





X xO 

F-2 

A^= ( A) -n ( X > - < C) 




SEC 


99 

c-=.i 

. 

... 

- .1 

SE J 


9B 

l--i. 

- j. 

- 

... ... 

ST A 

a a 

157 

-A A) 


T 

T - 


ci a a a 

C7 

M( .na.=sa)=^=( A) 





N / % / '""V 

f\ f \ I*-. 

0 / 

H< <X.l+x;.; 2 )^^<A) 





\ / % / t 

r \ X 

E7 

MC (X) + KKi )=-^(A) 





X xO 

py 

M ( X .1 - ( A) 




?:TOI'' 

■— 

0!E 

CMOS V e r s i o ri ci ri 1 y 

- - 

.... 

.... ... 

STX 

a a 

I5F 

M(aa)"=(X) 

. 

T 

T - 


a a a 

CF 

I'K a.naa)=-- (A) 





\ / \ / **y 

f\ /\ u. 

DF 

H< < X )+K>a)--< X ) 





xx.t 

EF 

i'1( ( X ) + ;.-:•! J. )" (X) 





/% A'-' 

FF 

M ( X ) < X ) 





i ). 

AO 

A^ - (A) - i i 

.... ... 

T 

T 1 


a. a 

150 

A~-^AA)--r'l<aa) 





a c; a a 

CO 

A=-(A)~ H( aaa.a) 






DO 

A-^AA) -TK < X) 2) 





'y t 

f% f ^ 

e:o 

A::= ( A ) -I'l ( (X) + X!!l. ) 





\* ) 

/ / \ vy 

FO 

A=^ (A) --ri < X ) 




;■ ;y I 

...... 

C!* 

S o T r e i r 1 1 e f r u 5 : 1 1 

- T 

- 

. 

TAX 

. 

97 

( X ) (A) 

. 


... ... 

T:;::r 

c) 

3Ti 

M(aa )-00 


T 

1 . 


% / \ / 1 
/ % / \ L 

6 D 

ri< <X) + XK.l )-00 





X ',<0 

7D 

M(X )-00 




TSTA 

....... 

4D 

(A) -00 

... .... 

T 

J .... 

■| S I X 


SD 

(X )-00 


1 

J . 

TXA 

....... 

9F 

( A) < X ) 



.... 

WA) T 


8F' 

CMiTS V e r s i 0 n 0 n 1 y 

... ... 

- 
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B.4 M6809 INSTRUCTIONS 

In the following table, the "Function" column for branch and long branch 
instructions only contains the test condition performed by the branch. The 
following function will be performed if the result of the test is true: 

P=(P)+0002+rr (for branch) 

P=(P)+0003+rrrr (for 1-byte long branch opcode) 

P=(P)+0004+rrrr (for 2-byte long branch opcode) 

If the result of the test is false, the following function will be performed: 

P=(P)+0002 (for branch) 

P=(P)+0003 (for 1-byte long branch opcode) 

P=(P)+0004 (for 2-byte long branch opcode) 

The functions for the instructions BSR, CWAI, DAA, EXG, JSR, LBSR, PSHS, PSHU, 
PULS, PULU, RTI, RTS, SEX, SWI, SWI2, SWI3, SYNC, and TFR are described in 
detail in the M6809 Programming Reference Manual. 
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M6809 Instructions 


Mne- Oper- ()p- Function Status 

monic and code F H I N Z V C 


ABX 

— 

3A 

ADC A 

il 

89 


aa 

99 


xxop 

A9 


aaaa 

B9 

ADCB 

ii 

C9 


aa 

D9 


xxop 

E9 


aaaa 

F9 

ADDA 

ii 

8B 


aa 

9B 


xxop 

AB 


aaaa 

BB 

ADUB 

ii 

CB 


aa 

DB 


xxop 

EB 


aaaa 

FB 

ADDD 

iiii 

C3 


aa 

D3 


xxop 

E3 


aaaa 

F3 

ANDA 

ii 

84 


aa 

94 


xxop 

A4 


aaaa 

B4 

ANDB 

ii 

C4 


aa 

D4 


xxop 

E4 


aaaa 

F4 

ANDCC 

ii 

1C 

ASL 

aa 

08 


xxop 

68 


aaaa 

78 

ASLA 

— 

48 

ASLB 

— 

58 

ASR 

aa 

07 


xxop 

67 


aaaa 

77 

ASHA 

— 

47 

ASHB 

— 

57 

BCC 

rr 

24 

BCS 

rr 

25 

BEQ 

rr 

27 

8GE 

rr 

2C 

BGT 

rr 

2E 

BHI 

rr 

22 

BHS 

rr 

24 


X=(X)+(B) 

A=(A)+ii+(C) 

A=(A)+ M(aa)+(C) 

A=(A)+xxop+(C) 
A=(A)+M(aaaa)+(C) 
B=(B) + ii<*(C) 

B=(B)+M(aa)+(C) 
B=(B)+xxop+(C) 

B=(B)+M(aaaa)+(C) 

A=(A)+ii 
A=(A)+M(aa) 

A=(A)+xxop 
A=(A)+M(aaaa) 

B=(B)+ii 
B=(B)+M(aa) 

B=(B)+xxop 

B=(B)+M(aaaa) 

D=(D)+iiii 

D=( D) +M( aa, aa+ I ) 

D=(U)+xxop 

D=(U)+M(aaaa,aaaa+l) 

A=(A) and ii 

A=(A) and M(aa) 

A=(A) and xxop 
A=(A) and M(aaaa) 
B=(B) and ii 
B=(B) and M(aa) 

B=(B) and xxop 
B=(8) and M(aaaa) 
CC=((X) and ii 
M(aa)=M(aa) A< 1 
xxop=xxop A< I 
M(aaaa)=M(aaaa) A< 1 
A=(A) A< I 
B=(B) A< 1 
M(aa)=M(aa) A> 1 
xxop=xxop A> 1 
M(aaaa)=M(aaaa) A> 1 
A=(A) A> I 
B=(B) A> I 
Test (0=0 
Test (0 = 1 
Test (Z)=l 
Test (N) xor (V)=0 
Test (Z) or KN) xor 
Test (C) xor (Z)=0 
Test (0=0 


- T - T T T r 

- T - T T r f 

- T - T T T T 

- T - T T T r 

-T T r r 

-T T 0 - 

-TTO- 

??????? 

- ? - T T ? f 

- ? - T T ? r 

- ? - T T ? r 

- ? - r T ? T 

- ? - T T ? T 

- ? - T T ? T 

(V)]=0 - - 
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M6809 Instructions 


Mne¬ 

monic 

Oper¬ 

and 

Op¬ 

code 

BITA 

11 

85 


aa 

95 


xxop 

A5 


aaaa 

B5 

BITB 

11 

C5 


aa 

05 


xxop 

E5 


aaaa 

F5 

BLE 

rr 

2F 

BLO 

rr 

25 

BLS 

rr 

23 

BIT 

rr 

2D 

BMI 

rr 

2B 

BNE 

rr 

26 

BPL 

rr 

2A 

BRA 

rr 

20 

BHN 

rr 

21 

8SR 

rr 

80 

BVC 

rr 

28 

BVS 

rr 

29 

CLR 

aa 

OF 


xxop 

6F 


aaaa 

7F 

CLRA 

— 

4F 

CLRB 

— 

5F 

CMFA 

ii 

81 


aa 

91 


xxop 

A1 


aaaa 

B1 

CMPB 

il 

Cl 


aa 

01 


xxop 

El 


aaaa 

FI 

CMPD 

iiii 

10,83 


aa 

10,93 


xxop 

10, A3 


aaaa 

10, B3 

CMPS 

iiii 

1 1 ,8C 


aa 

1 1 ,9C 


xxop 

1 1 ,AC 


aaaa 

1 1 ,BC 

CMPU 

iiii 

1 1 ,83 


aa 

1 1 ,93 


xxop 

1 1 ,A3 


aaaa 

1 1 ,B3 

CMPX 

iiii 

8C 


aa 

9C 


xxop 

AC 


aaaa 

BC 


Function 


(A) and 11 
(A) and M(aa) 

(A) and xxop 

(A) and M(aaaa) 

(B) and 11 
(B) and M(aa) 

(B) and xxop 
(B) and M(aaaa) 

Test (Z) or I(N) xor 
TEST (0 = 1 

Test (C) or (Z)=l 

Test (N) xor (V)=l 

Test (N)=l 

Test (Z)=0 

Test (N)=0 

Tests always true 

Tests always false 

Subroutine call 

Test (V)=0 

Test (V)=l 

M(aa)=00 

xxop=00 

M(aaaa)=00 

A=00 

B=00 

(A)-ii 

(A)-M(aa) 

(A)-xxop 

(A) -M(aaaa) 

(B) -ii 

(B)-M(aa) 

(B)-xxop 
(B)-M(aaaa) 

(D)-iiii 
(D)-M(aa,aa+1) 

(D)~xxop 

(D)-M(aaaa,aaaa+1) 
(S)-iiii 
(S)-M(aa,aa+)) 
(S)-xxop 

(S)-M(aaaa,aaaa+1) 

(U)-iiii 

(U)-M(aa,aa+l) 

(U)-xxop 

(U)-M(aaaa,aaaa+1) 

(X)-iiii 

(X)-M(aa,aa+l) 

(X)-xxop 

(X)-M(aaaa,aaaa+1) 


Status 

F H I N Z V C 

-T T 0 - 

-T T 0 - 

(V)]=l- 


---0100 

- 0 10 0 

- 0 1 0 0 

- ? - T T T T 

- ? - T T T r 

-T T T T 

-T T T r 

-T T T T 

-T T T T 
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M6809 Instructions 


Mne¬ 

monic 

Oper¬ 

and 

Op¬ 

code 

Function 

F 

Status 

H I N Z 

V 

c 

CMPY 

iiii 

10.8C 

<Y)-iiii 




T 

T 

T 

T 


aa 

10,9C 

(Y)-M(aa,aa+1) 









xxop 

10,AC 

(Y)-xxop 









aaaa 

10,BC 

(Y)-M(aaaa,aaaa+1) 








COM 

aa 

03 

M(aa)=M(aa) xor $FF 

- 

- 

- 

T 

T 

0 

1 


xxop 

63 

xxop=xxop xor $FF 









aaaa 

73 

M(aaaa)=M(aaaa) xor $FF 








COMA 

— 

43 

A=(A) xor $FF 

- 

- 

- 

T 

T 

0 

1 

COMB 


53 

B«(B) xor $FF 

- 

- 

- 

T 

T 

0 

1 

CWAI 

ii 

3C 

Clear and wait for interrupt? 

? 

? 

? 

? 

? 

? 

DAA 

— 

19 

Converts binary add of 

- 

- 

- 

T 

T 

T 

T 




BCD into BCD 








DEC 

aa 

OA 

M(aa)*M(aa)-01 

- 

- 

- 

T 

T 

? 

- 


xxop 

6A 

xxop=xxop-01 









aaaa 

7A 

M(aaaa)=M(aaaa)-01 








UECA 

— 

4A 

A=(A)-01 

- 


- 

T 

T 

? 

— 

DECB 

— 

5A 

B»(B)-01 



— 

T 

T 

? 


EOHA 

ii 

88 

A*(A) xor ii 

- 


- 

T 

T 

0 

- 


aa 

98 

A=(A) xor M(aa) 









xxop 

A8 

A=(A) xor xxop 









aaaa 

B8 

A=(A) xor M(aaaa) 








EOHB 

ii 

C8 

B*(B) xor ii 

- 

- 

— 

T 

T 

0 



aa 

D8 

B*(B) xor M(aa) 









xxop 

E8 

B*(B) xor xxop 









aaaa 

F8 

B*(B) xor M(aaaa) 








EXG 

rl 

IE 

Exchange 2 registers 

? 

? 

? 

? 

? 

? 

? 

INC 

aa 

OC 

M(aa)=M(aa)+01 

- 

- 

- 

T 

T 

? 

— 


xxop 

6C 

xxop=xxop+01 









aaaa 

7C 

M(aaaa)=M{aaaa)+01 








INCA 

— 

4C 

A»(A)+01 

— 

— 

— 

T 

T 

? 

— 

INCB 

— 

5C 

B=(B)+01 

— 

— 

— 

T 

r 

? 


JMP 

aa 

OE 

P*aa 

- 

- 

- 

- 

- 

— 

- 


xxop 

6E 

P“xxop 









aaaa 

7E 

P=aaaa 








JSH 

aa 

9D 

Subroutine call 

- 

- 

- 

- 

— 

— 

— 


xxop 

AD 

Subroutine call 









aaaa 

BD 

Subroutine call 








LBCC 

rrrr 

10,24 

Test (0=0 

— 

— 

- 

- 

- 



LBCS 

rrrr 

10,25 

Test <0 = 1 

- 

- 

- 

- 

— 

— 

- 

LBEQ 

rrrr 

10,27 

Test (Z)=l 

- 

- 

- 

- 

- 


- 

LBGE 

rrrr 

10,2C 

Test (N) xor (Y)=0 

- 

- 

- 

— 

— 

— 

— 

LBGT 

rrrr 

10,2E 

Test (Z) or KN) xor (V)]=0 

- 

— 


— 

- 

- 

— 

LBHI 

rrrr 

10,22 

Test (C) xor (Z)=0 

— 

— 

— 


— 


-- 

LBHS 

rrrr 

10,24 

Test (0=0 

— 


— 



— 


LBLE 

rrrr 

10,2F 

Test (Z) or KN) xor (V)]=l 

— 

— 

— 





LBLO 

rrrr 

10,25 

Test (0 = 1 

— 



— 




LBLS 

rrrr 

10,23 

Test (C) or (Z)=l 

- 

— 

— 

— 

— 

— 

— 

LBLT 

rrrr 

10,2D 

Test (N) xor (\/) = l 

— 

— 

— 

«- 



— 

LBMI 

rrrr 

10,2B 

Test (N) = l 

- 

— 

— 

- 

- 

— 

— 
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M6809 Instructions 


Mne- Opel— Op- Function 

monlc and code 


LBNE 

rrrr 

10,26 

LBPL 

rrrr 

10,2A 

LBHA 

rrrr 

16 

LBRN 

rrrr 

10,21 

LBStt 

rrrr 

17 

LBVC 

rrrr 

10,28 

LBVS 

rrrr 

10,29 

LDA 

li 

86 


aa 

96 


xxop 

A6 


aaaa 

B6 

LDB 

ii 

C6 


aa 

D6 


xxop 

E6 


aaaa 

F6 

LDU 

iiii 

CC 


aa 

DC 


xxop 

EC 


aaaa 

FC 

LDS 

iiii 

10,CE 


aa 

10,D£ 


xxop 

10,EE 


aaaa 

10, FE 

LDU 

iiii 

CE 


aa 

DE 


xxop 

EE 


aaaa 

FE 

LDX 

iiii 

8E 


aa 

9E 


xxop 

AE 


aaaa 

BE 

LDY 

iiii 

10,8E 


aa 

10,9E 


xxop 

10,AE 


aaaa 

10,BE 

LEAS 

xxop 

32 

LEAU 

xxop 

33 

LEAX 

xxop 

30 

LEAY 

xxop 

31 

LSL 

aa 

08 


xxop 

68 


aaaa 

78 

LSLA 

— 

48 

LSLB 

— 

58 

LSR 

aa 

04 


xxop 

64 


aaaa 

74 


Test (Z)=0 

Test (N)=0 

Tests always true 

Tests always false 

Subroutine call 

Test (V)=0 

Test (V)=l 

A»ii 

A=M(aa) 

A=xxop 
A=M(aaaa) 

B=ii 
B=M(aa) 

B=xxop 
B=M(aaaa) 

D=iiil 

D=M(aa,aa+l) 

D=xxop 

D=M(aaaa«aaaa+1) 
S=liii 

S=M(aa,aa+l) 

S=xxop 

S=M(aaaa,aaaa+l) 
U=iiii 

U=M(aa,aa+1) 

U=xxop 

U=M(aaaa,aaaa+l) 
X=liii 

X=M(aa,aa+l) 

X=xxop 

X=M(aaaa,aaaa+I) 

ir=iiii 

Y=M(aa,aa+1) 

Y=xxop 

Y=M(aaaa,aaaa+I) 
S»effad xxop 
U=effad xxop 
X=effad xxop 
Y=effad xxop 
M(aa)=M(aa) A< I 
xxop=xxop A< 1 
M(aaaa)=M(aaaa) A< I 
A=(A) A< I 
B=(B) A< I 
M(aa)=M(aa) L> I 
xxop=xxop L> 1 
M( aaaa ) = M( aaaa) L> 1 


Status 

F H I N Z V C 


-T T 0 - 

-T T 0 - 

-T T 0 - 

-T T 0 - 

-T T 0 - 

-T T 0 - 

-T T 0 - 


- ? - T T ? T 


- ? - T T ? T 

- ? - T T ? r 

-0 T - T 
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M6809 Instructions 


Mne- 
moni c 

Oper¬ 

and 

Op¬ 

code 

Function 


F 

Status 

H I N Z 

V 

c 

LSRA 


44 

A=(A) L> 1 





0 

r 


1 

LSHB 

— 

54 

B=(B) L> 1 


- 

- 

- 

0 

T 

- 

r 

MUL 

— 

3U 

0=(A)*(B) 


- 

- 

- 

- 

T 

- 

f 

REG 

aa 

00 

M(aa)=00-M(aa) 


- 

? 

- 

T 

T 

? 

r 


xxop 

60 

xxop=00-xxop 










aaaa 

70 

M(aaaa)=00-M(aaaa) 









NEGA 

—- 

40 

A=00-( A) 


- 

? 

- 

T 

T 

? 

r 

NEGB 

— 

50 

B=00-(B) 


- 

? 

- 

T 

T 

? 

r 

WOP 

— 

12 

P=(P)+000l 


• 

- 

- 

- 

- 

- 

- 

OHA 

il 

8A 

A=(A) or ii 


- 

• 

- 

T 

T 

0 

- 


aa 

9A 

A=(A) or M(aa) 










xxop 

AA 

A=(A) or xxop 










aaaa 

BA 

A=(A) or M(aaaa) 









ORB 

ii 

CA 

B=(B) or ii 


- 

- 

- 

T 

T 

0 

— 


aa 

DA 

B=(B) or M(aa) 










xxop 

EA 

B=(B) or xxop 










aaaa 

FA 

B=(B) or M(aaaa) 









OHCC 

ii 

1 A 

CC=(CC) or ii 


7 

? 

? 

? 

? 

? 

7 

PSHS 

rl 

34 

Push registers on M(S) 

— 

- 

- 

— 

— 

- 

— 

PSHU 

rl 

36 

Push registers on M(U) 

- 

- 

- 

- 

- 

- 

- 

PULS 

rl 

35 

Pull registers from 

M(S) 

? 

i 

? 

? 

? 

i 

7 

PULU 

rl 

37 

Pull registers from 

M(U) 

? 

? 

? 

? 

? 

? 

7 

ROL 

aa 

09 

M(aa) = M(aa) R< 1 


- 

- 

• 

T 

T 

? 

r 


xxop 

69 

xxop=xxop R< 1 










aaaa 

79 

M(aaaa)=M(aaaa) R< 1 









ROLA 

— 

49 

A=(A) R< 1 


— 

— 

— 

r 

T 

? 

r 

ROLB 

— 

59 

B=(B) H< 1 


— 

— 

— 

T 

T 

? 

T 

ROR 

aa 

06 

M(aa)=:M(aa) R> 1 


- 

- 

- 

T 

T 

? 

T 


xxop 

66 

xxop=xxop H> 1 










aaaa 

76 

M{aaaa)=M(aaaa) R> 1 









RORA 

— 

46 

A=(A) R> 1 


- 

— 

— 

T 

T 

? 

T 

ROHB 

— 

56 

B=(B) R> I 


- 

- 

- 

r 

T 

? 

r 

RTI 

— 

3B 

Return from interrupt 

i 

? 

? 

? 

? 

? 

7 

RTS 

— 

39 

Return from subroutine 

- 

- 

- 

- 

- 

- 

- 

SBC A 

ii 

82 

A=(A)-ii-(C) 


— 

— 

— 

T 

T 

r 

r 


aa 

92 

A=(A)-M(aa)-(C) 










xxop 

A2 

A=(A)-xxop-(C) 










aaaa 

B2 

A=(A)-M(aaaa)-(C) 









SBCB 

ii 

C2 

B=(B)-ii-(C) 


— 

— 

— 

T 

T 

T 

f 


aa 

02 

B=<B)-M(aa)-(C) 










xxop 

E2 

B=(B)-xxop-(C) 










aaaa 

F2 

B=(B)-M(aaaa)-(C) 









SEX 

— 

ID 

Sign extension of B 

into A 

- 

- 

- 

T 

T 

0 

- 

STA 

aa 

97 

M( aa) = (A) 


- 

- 

- 

T 

T 

0 

— 


xxop 

A7 

xxop=(A) 










aaaa 

87 

M(aaaa)=(A) 
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M6809 Instructions 


Mne- Oper— Op- Function 

monic and code 


STB 

aa 

D7 


xxop 

E7 


aaaa 

F7 

STD 

aa 

DD 


xxop 

ED 


aaaa 

FD 

STS 

aa 

10,DF 


xxop 

10,EF 


aaaa 

10, FF 

STU 

aa 

DF 


xxop 

EF 


aaaa 

FF 

STX 

aa 

9F 


xxop 

AF 


aaaa 

BF 

STY 

aa 

10,9F 


xxop 

10,AF 


aaaa 

10,BF 

SUBA 

ii 

80 


aa 

90 


xxop 

AO 


aaaa 

BO 

SUBB 

ii 

CO 


aa 

DO 


xxop 

EO 


aaaa 

FO 

SUBD 

iiil 

83 


aa 

93 


xxop 

A3 


aaaa 

B3 

SWI 

— 

3F 

SrtI2 

— 

10,3F 

SWI3 

— 

11 ,3F 

SYNC 

— 

13 

TFH 

rl 

IF 

TST 

aa 

OD 


xxop 

6D 


aaaa 

7D 

rSTA 

— 

4D 

TSTB 


5D 


M(aa)=(B) 
xxop=(B) 

M(aaaa)*(B) 

M(aa,aa+I)=(D) 
xxop=(D) 

M(aaaa,aaaa+l)=(D) 

M( aa, aa-*-1 ) = ( S) 
xxop=(S) 

M(aaaa,aaaa+l)=(S) 

M(aa,aa+l)=(U) 
xxop=(U) 

M(aaaa» aaaa + l) = (U) 

M(aa♦aa+1)=(X) 
xxop=(X) 

M(aaaa,aaaa+l)=(X) 
M(aa,aa+1 ) = ( Y) 
xxop=(Y) 

M(aaaa,aaaa+l)=(Y) 
A=( A)-ii 
A=i( A)-M( aa) 

A=( A)-xxop 
A=(A)-M(aaaa) 
B=(B)-ii 
B=(B)-M(aa) 

B=(B)-xxop 

B=(B)-M(aaaa) 

D=(D)-iiii 

D=<D)-M(aa,aa+1 ) 

D=(D)-xxop 

D=(D)-M(aaaa,aaaa+l) 

Software interrupt 

Software interrupt 

Software interrupt 

Synchronize 

Transfer register 

M(aa)-00 

xxop-00 

M(aaaa)-00 

(A) -OO 

(B) -OO 


Status 

F H I N Z V C 

- r T 0 - 

-T T 0 - 

- T T 0 - 

-T T 0 - 

-T T 0 - 

- TTO- 

- ? - T T T f 

- ? - T T r r 

-T T T T 


i ? ? ? ? V ? 
-T T 0 - 


-T T 0 0 

- - - T T 0 0 
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B.5 M6809 INDEXED ADDRESSING MODES 

The value of the post-byte (the first byte following the opcode) for instruc¬ 
tions using the indexed addressing mode is determined by the format of the 
operand. Two formats exist: simple indexing and complex indexing. Simple 
indexing is used when the operand is of the form: 

<exp>,R 

where <exp> is an absolute expression in the range -16 to 15 but not equal to 
zero, and R is one of the index registers "S", "U", "X", or "Y". All other 
indexed addressing modes use the complex indexing format. The two post-byte 
formats are described below: 

Simple Indexing -- Post-Byte 


7 

6 5 

4 3 2 1 

0 

: 0 

! RR 

: OFFSET 

1 

where 

RR=00 if 
01 if 

10 if 

11 if 

X register 

Y register 

U register 

S register 



0FFSET=5- 

■bit 2's complement 



Complex 

Indexing -- Post-Byte 

7 6 5 

4 3 2 1 0 

111 RR 

: I : TTTT : 

where RR= 00 

if X or PCR 

01 

if Y 

10 

if U 

11 

if S 

1= 0 if no indirect 

1 if indirect 

TTTT=0000 

Single auto-increment (R+) 

0001 

Double auto-increment (R++) 

0010 

Single auto-decrement (-R) 

0011 

Double auto-decrement (--R) 

0100 

0 offset value or no offset 

0101 

Accumulator B is offset (B,R) 

0110 

Accumulator A is offset (A,R) 

1000 

8-bit offset 

1001 

16-bit offset 

1011 

Accumulator D is offset (D,R) 

1100 

8-bit offset with PCR 

1101 

16-bit offset with PCR 

nil 

Extended indirect 


B-21 



B.6 M6800/M6801 INSTRUCTIONS AND M6809 EQUIVALENTS 

Not all M6800/M6801 instructions have exact equivalences recognized by the 
M6809 Macro Assembler. Some translate into instructions that generate more 
bytes by the M6809 Macro Assembler. However, all opcode mnemonics recognized 
by the M6800/M6801 Macro Assembler are recognized by the M6809 Macro Assembler, 
and are translated into equivalent M6809 code where possible. Some translations 
are not equivalent, but the same function is still performed. In addition, some 
"M6800-like" mnemonics are recognized by the M6809 Macro Assembler and translate 


M6800/M680I Mnemonic Type of Instruction M6809 Equivalent 


ABA 

ASLU 

CBA 

CLC 

CLF 

CL I 

CLIP 

CLV 

CFX 

JES 

DEX 

OEY 

INS 

I NX 

I NY 

LDAAI LDA A 
LDABI LDA B 
LOAD 
LSLD 

LSHD 

OHAAl OHA A 
OHABI OHA B 
FSHAI HSH A 
FSriBi PSH B 
PSHX 

PULAI PUL A 
PULBl PUL B 
PULX 
SBA 


6800 

6801 

6800 

6800 

6800-1ike 
6800 

6800-like 

6800 

6800 

6800 

6800 

6800-1ike 

6800 

6800 

6800-1 ike 
6800 
6800 
6801 
6801 

6301 

6800 

6800 

6800 

6800 

6801 

6800 

6800 

6801 

6800 


PSHS 

8 

ADDA 

S+ 

ASLB 


HOLA 


PSHS 

8 

CM P A 

S+ 

ANDCC 

#$FE 

ANDCC 

#$BF 

ANDCC 

#$EF 

ANDCC 

^$AF 

ANDCC 

#$FD 

CMPX 


LEAS 

-1 .5 

LEAX 

-1 ,x 

LEAY 

-1 .Y 

LEAS 

i,s 

LEAX 

1 ,x 

LEAY 

I.Y 

LDA 


LDA 


LDD 


ASLB 


HOLA 


LSHA 


HOHB 


OHA 


ORB 


PSHS 

A 

PSHS 

8 

PSHS 

X 

PULS 

A 

PULS 

8 

PULS 

X 

PSHS 

8 

SUBA 

S+ 
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M6800/M6801 Mnemonic 

Type of Instruction 

M6809 Equivalent 

SEC 


6800 

ORCC #$0I 

SEE 


6800-like 

ORCC #$40 

SEI 


6800 

ORCC #$I0 

SEIF 


6800-like 

ORCC #$50 

SEV 


6800 

ORCC #$02 

STAAl 

ST A A 

6800 

STA 

stab; 

STA B 

6800 

STB 

STAU 


6801 

STD 

TAB 


6800 

TFR A,8 

TSTA 

TBA 


6800 

TFR B.A 

TSTA 

TAP 


6800 

TFR A,CC 

TPA 


6800 

TFR CC,A 

rsx 


6800 

TFR S,X 

TXS 


6800 

TFR X,S 

^AI 


6800 

CrtAl #$FF 
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APPENDIX C 


DIRECTIVE SUMMARY 


A complete description of all directives appears in Chapter 4. 
ASSEMBLY CONTROL 


END 

Program end 

FAIL 

Programmer generated errors 

NAM 

Assign program name 

ORG 

Origin program counter 

SETDP 

Set direct page pseudo register (M6809 

SYMBOL DEFINITION 

ENDM 

Macro definition end 

EQU 

Assign permanent value 

MACR 

Macro definition start 

REG 

Register list definition (M6809 only) 

SET 

Assign temporary value 

DATA DEFINITION/STORAGE ALLOCATION 

BSZ 

Block storage of zero; single bytes 

FCB 

Form constant byte 

FCC 

Form constant character string 

FDB 

Form constant double byte 

RMB 

Reserve memory; single bytes 

PROGRAM RELOCATION 

ASCT 

Absolute section 

BSCT 

Base section 

COMM 

Named common section 

CSCT 

Blank common section 

DSCT 

Data section 

IDNT 

Identification record 

PSCT 

Program section 

OPT REL 

Relocatable output selected 

XDEF 

External symbol definition 

XREF 

External symbol reference 
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CONDITIONAL ASSEMBLY 


ENDC 

IFC 

IFEQ 

IFGE 

IFGT 

IFLE 

IFLT 

IFNC 

IFNE 


LISTING CONTROL 


OPT 

ABS 

OPT 

CL 

OPT 

NOCL 

OPT 

CMO 

OPT 

NOCMO 

OPT 

CRE 

OPT 

G 

OPT 

NOG 

OPT 

L 

OPT 

NOL 

OPT 

LLE=n 

OPT 

LOAD 

OPT 

M 

OPT 

MC 

OPT 

NOMC 

OPT 

MD 

OPT 

NOMD 

OPT 

MEX 

OPT 

NOMEX 

OPT 

0 

OPT 

NOO 

OPT 

P=n 

OPT 

NOP 

OPT 

REL 


End of current level of conditional assembly 

Assemble if strings compare 

Assemble if expression is equal to zero 

Assemble if expression is greater than or equal to zero 

Assemble if expression is greater than zero 

Assemble if expression is less than or equal to zero 

Assemble if expression is less than zero 

Assemble if strings do not compare 

Assemble if expression is not equal to zero 


Select absolute MDOS-loadable object output 
Print conditional assembly directives 
Don't print conditional assembly directives 
Allow CMOS instructions STOP and WAIT (M6805 only) 

Don't allow CMOS instructions STOP and WAIT (M6805 only) 
Print cross reference talbe 

Print generated lines of FCB, FCC, and FDB directives 
Don't print generated lines of FDB, FCC, and FDB directives 
Print source listing from this point 
Inhibit printing of source listing from this point 
Change line length 

Select absolute EXORciser-loadable object output 

Create object output in memory 

Print macro calls 

Don't print macro calls 

Print macro definitions 

Don't print macro definitions 

Print macro expansions 

Don't print macro expansions 

Create object output file 

Do not create object output file 

Change page length 

Inhibit paging and printing of headings 
Select relocatable object output 
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OPT S 
OPT SE 
OPT U 
OPT NOU 
OPT W 
OPT NOW 
OPT Zj31 
OPT MOZ01 
PAGE 
SPC 
TTL 


Print symbol table 

Print user-supplied sequence numbers 
Print unassembled code from conditional directives 
Don't print unassembled code from conditional directives 
Print warnings (M6809 only) 

Don't print warnings (M6809 only) 

Allow M6801 instruction mnemonics (M6800 only) 

Don't allow M6801 instruction mnemonics (M6800 only) 
Print subsequent statements on top of next page 
Skip lines 

Initialize heading for source listing 
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APPENDIX D 


ASSEMBLER MESSAGES 


A description of all error and warning messages follows. Warning messages 
are only supported by the M6809 Macro Assembler. Some error messages only 
occur when using the M6809 Macro Assembler or the M6805 Macro Assembler. 

The format of the error is: 

****ERR0R XXX— YYYYY 

where XXX is the error message number, and YYYYY is the line number of the 
previously encountered error. If YYYYY = 00000, this indicates that there 
is no previous error. The format of the warning messages is similar. The 
EDOS and tape versions of the M6800 Macro Assembler do not include the line 
number of the last error. 

D.l ERROR MESSAGES 

169 Invalid bit number (M6805 only) 

The bit number in bit set/clear and bit test and branch instructions 
must be an absolute number in the range 0-7. 

173 Invalid use of direct mode indicator (M6809 only) 

The direct mode indicator, "<", was specified in the extended indirect 
addressing mode (e.g., LDA <[VAR]). The "<" is ignored. 

174 Invalid auto increment/decrement format (M6809 only) 

Single auto increment or decrement was specified in the indirect mode 
(e.g., LDA [X+]) or more than two minus or plus signs detected (e.g., 

LDA -—X). 

175 Invalid index register format (M6809 only) 

One of the accumulators "A", "B", or "D" was specified as the offset 
in the indexed mode, but was not followed by one of the index registers 
"S", "U", "X", or "Y" (e.g., LDA A,PCR). 

176 Invalid expression for PSH/PUL (M6809 only) 

The immediate expression following one of the instructions PSHS, PULS, 
PSHU, or PULU contained symbols defined with other than the REG 
directive (Paragraph 4.27), contained an operator other than "I+", or 
contained no symbols following the (e.g., PSHU #$FF; PSHS #REG1*REG2), 

177 Incompatible register for PSH/PUL instruction (M6809 only) 

The register list for the PSHS/PULS instructions cannot contain the 
register "S", and the register list for the PSHU/PULU instructions 
cannot contain the register "U". The register list specified with the 
REG directive cannot contain both "U" and "S". In the case with the 
REG directive, the value assigned to the symbol will be the first "U" 
or "S" encountered (e.g., PSHS S). 

178 Invalid register operand specification (M6809 only) 

Undefined register name encountered in register list; not exactly two 
register names in register list specification for TFR or EXG instructions 
or no register list specified for PSH/PUL instructions. VAlid register 
names are: A, B, CC, D, DP, PC, S, U, X, and Y (e.g., TFR A,B,X; PULU Q) 
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179 Incompatible register pair (M6809 only) 

The register pair of an EXG instruction was not the same size (i.e., 
two 16-bit registers or two 8-bit registers), or the register pair 
specification of a TFR instruction indicated a transfer from an 8-bit 
register to a 16-bit register. The 8-bit registers are: "A", "B", 

"CC", and "DP". The 16-bit registers are: "D", "PC", "S", "U", "X", 
and "Y" (e.g., EXG X,A; TFR B,PC). 

202 Label or opcode error 

The label or opcode symbol does not begin with an alphabetic character 
or a period. 

205 Label error 

The statement label field is not terminated with a blank. This usually 
occurs if an invalid character is used in the label. 

207 Undefined opcode 

The symbol in the opcode field is not a valid opcode mnemonic, directive 
or macro definition. 

208 Branch out of range 

The operand resulted in an offset greater than 129 bytes forward or 
126 bytes backward from the first byte of the branch instruction. This 
error may also occur if the operand is in a different program section 
(relocatable) than the current program counter section. 

209 Illegal addressing mode 

The specified addressing mode in the operand field is not valid with 
this instruction type. 

210 Byte overflow -- operand too large 

The operand's value exceeded 1 byte (8 bits). The most significant 
eight bits of the 16-bit expression must be all zeros or all ones for 
a one-byte field. 

211 Undefined symbol 

The symbol never appears in a label field. 

212 Directive operand error 

A syntax error was detected in the operand field of a directive. 

214 FOB directive syntax error 

The structure of the FOB directive is syntactically incorrect. 

215 FDB directive operand error 

The structure of the FDB directive is syntactically incorrect. 

216 Directive operand error 

The directive's operand field is missing, terminated by an invalid 
terminator, or an expression in the operand field contains an invalid 
operator. 

217 Option error 

An option in the operand field of the OPT directive was undefined. 
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219 No END statement 

The END directive was not found at the end of the last source file. 

The END directive is automatically supplied. 

220 Phasing error 

The value of the program counter during pass 1 and pass 2 for the same 
instruction is different. 

221 Symbol table or macro table overflow 

The symbol table or macro table has overflowed. This is a fatal error, 
and terminates the Assembler during pass 1. 

222 Reserved symbol used 

One of the reserved symbols (A, B, or X) appeared in the label field 
or in the operand field of a statement. These symbols can only be 
used in the operation field to modify the root mnemonic (A or B) or 
in the operand field to specify indexed addressing (e.g., ,X). For 
the M6809 Macro Assembler, other reserved symbols are Y, U, S, D, CC, 
DP, PC, and PCR. For the M6805 Macro Assembler, only A and X are 
reserved symbols. 

223 The directive must or must not have a label 

Depending on the directive used, the label field must be blank or must 
contain a valid symbol. 

225 Named common name used in expression 

A named common section name can only appear in the label field of 
another COMM directive. Its use anywhere else is invalid. 

226 Illegal parenthesis 

The parentheses in an expression do not balance. 

227 Too many digits in numeric constant 

An overflow in the numeric evaluation of a constant was detected. 

Also used if a sequence number is missing on a line in a file that 
has sequence numbers. 

228 Invalid usage of operator 

The multiplication, division, and two-character operators cannot be 
used in a relocatable expression or with external references. 

229 Invalid starting execution address 

The starting execution address specified as the expression on the END 
statement is not within the range of the MDOS-loadable object file. 

This can happen, since RMB's at the beginning or end of the program 
are not included in the range of the program. 

230 CSCT initialization error 

No initialized code can be placed into CSCT. 

231 Multiple relocatable section types 

More than one relocatable section type occurred in the evaluation of 
an expression or one relocatable symbol occurred with a unary minus 
preceding it. 
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232 Relocation count error 

The relocation count for a given section after an expression evaluation 
was greater than one (e.g., adding two PSCT symbols). 

233 Symbol name too large 

A symbol of greater than 6 characters was encountered. 

234 Multiply defined symbol 

A reference was made to a multiply defined symbol. 

235 Memory error 

The OPT M option was used and object code was going to be written into 
non-existent memory or into contiguous memory belonging to the Assemble) 

236 Program counter overflow 

The program counter overflowed its maximum value for a particular 
section ($FF for BSCT, $FFFF for all other sections). 

237 Invalid terminator for sequence number 

The character following a user-supplied sequence number was not a blank, 

238 Section table overflow 

Too many ASCT and named common sections were specified. This is a 
fatal error, and terminates the Assembler during pass 1. 

239 Illegal directive in absolute mode 

A relocation directive (e.g., PSCT, COMM, etc.) was used, but the 
relocation option (OPT REL) was not specified. 

240 Inconsistent or invalid named common operand 

The operand field of the COMM directive did not contain BSCT, DSCT, or 
PSCT specifications; or the operand field was different from the one 
used the first time. 

241 Illegal symbol used in an expression 

An undefined forward reference, external reference, or relocatable 
symbol was used illegally in an expression. The instruction will 
not be relocated by the M6800 Linking Loader. 

242 OPT directive error 

The "LOAD", "REL", or "ABS" options were used in combination; the "REL" 
option was not ASCT or the program counter was not zero; or the "CRE" 
option was used after the first symbol had already been placed into 
the symbol table. 

243 XREF or XDEF directive operand error 

An invalid symbol or no operand was detected in the operand field of 
the XDEF or XREF directive. 

244 Illegal page or listing line length 

A page or listing line length was not within the allowed range. 
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245 Invalid use of common variable 

A variable in blank or named common cannot be used in the operand 
field of the XDEF, XREF, or COMM directive. 

247 Invalid terminator for an operand 

The character following the legal part of an operand is not a valid 
terminator (usually a carriage return or space). For the M6809 Macro 
Assembler, this error could occur if invalid indirect pairing; i.e., 
an operand has "[" but no "]". 

248 Macro definition error 

An attempt was made to define a macro that already existed. 

249 Macro parenthesis error 

Parentheses in macro call argument are not balanced. 

250 Macro definition nest error 

A macro directive was encountered during a macro expansion. Macro 
definitions cannot be nested. 

251 Macro expansion nest error 

Macro calls were nested too deep, or the number of ENDM directives 
does not match the number of MACR directives. 

252 Invalid macro argument index 

The character following a backslash (\) during macro expansion was not 
an alphanumeric or a period. 

253 IFC, IFNC directive syntax error 

No operand was found or no comma was found to separate the two arguments. 

254 Conditional directives nest error 

Conditional directives were nested too deep, or the number of ENDC 
directives did not match the number of IFxx directives. 


255 FAIL directive warning 

The FAIL directive (a planned program error) was encountered. 
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D.2 M6809 WARNING MESSAGES 

1 Long branch not required 

A long branch instruction was used to branch to an address within 
the range -126 to +129. Although the long branch instruction could 
be changed to a short branch, it could result in other out-of-range 
short branches. 

2 Extended addressing should be used 

Direct addressing was forced by using the "<" indicator. However, the 
direct page pseudo register assigned by the SETDP directive (Paragraph 
4.27) indicated that the extended mode should have been used. 

3 Duplicate register specification 

The same register name was specified more than once in a register list. 
Register "D" specified with either register "A" or "B" gives this 
warning. 

4 Possible SETDP expression error 

The most significant byte of the expression in a SETDP directive was 
not zero. The direct page pseudo register is assigned the value of 
the least significant byte anyway. 

5 Extended addressing should be used 

Direct addressing was forced by using the "<" indicator with a CSCT, 
DSCT, or PSCT non-external expression. The expression will not be 
relocated by the M6800 Linking Loader. 

6 Possible transfer error 

The TFR instruction was used with a transfer from a 16-bit register 
to an 8-bit register. The result of such a transfer is to move the 
least significant byte of the 16-bit register to the 8-bit register. 
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APPENDIX E 


ASSEMBLER OUTPUT FORMAT 


All the numeric information printed on the source listing is in hexadecimal, 
unless otherwise noted. 

E.l M6800/M6801 FORMAT 

The MDOS version of the Macro Assembler will automatically print user-supplied 
sequence numbers in the left margin if they appear in the source file. However, 
the EDOS and tape versions of the Assembler will only print sequence numbers 
under control of the OPT directive. Then the sequence numbers will be printed 
in the right-most five columns of the source listing. Thus, the column titled 
"SEQ #" in the following table does not apply to EDOS and tape versions of the 
Macro Assembler. 

COLUMN 


SEQ # 

NO SEQ # 

CONTENTS 

1-5 

— 

USER-SUPPLIED SEQUENCE NUMBER 

< decimal;:- 

T’-ll 

1-5 

SOURCE LINE NUMBER.: A FIVE-DIGIT 

DECIMAL COUNTER MAINTAINED BV THE 
ASSEMBLER 

12 

6 

PROGRAM COUNTER SECTION FLAG <;A=ASCT.. 
B=BSCT.. C=CSCT.. D=DSCT.. N=NAMED 

COMMON.. p=psct:) 

14-1? 

8-11 

CURRENT PROGRAM COUNTER 

lS'-20 

13-14 

MACHINE OPERATION CODE 

22-23 

24-25 

28 

16-1? 

18-19 

FOR NON-BRANCH INSTF^lUCTIONS: 

FIRST BYTE OF OPERAND 

SECOND BYTE OF OPERAND <IF ANY> 
OPERAND SECTION FLAG <A. B.. C.. D. 
N.. p :> 

22-23 

25-28 

16-1? 

19—22 

FOR BRANCH INSTRUCTIONS: 

RELATIVE BRANCH OFFSET 

ABSOLUTE ADDRESS OF DESTINATION 

25-28 

19-22 

FOR DIRECTIVES LIKE BS2. EQU.. ORG.. 
ETC: 

VALUE OF EXPRESSION 

30-35 

24-29 

LABEL FIELD 

37-42 

31-36 

OPERATION FIELD 

43-50 

3?-44 

OPERAND FIELD.: LONGER OPERANDS EXTEND 
INTO THE COMMENT FIELD 

52-132 

46-132 

COMMENT FIELD 
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E.2 M6805 FORMAT 


The M6805 Macro Assembler will automatically print user-supplied sequence 
numbers in the left margin if they appear in the source file. 


COLUMN 


Seq # 

No Seq # 

CONTENTS 

\-5 

— 

User-supplied sequence number (decimal 

7-11 

1-5 

Source line number* a five-digit decim 
counter maintained by the assembler 

12 

6 

Program counter section flag (A=ASCT, 
B=BSCT, C=CSCT, D=DSCT» N= Named Common 
P=PCST) 

14-17 

8-1 1 

Current program counter 

19-20 

13-14 

Machine operation code 

22-23 

24-25 

31 

16-17 

18-19 

25 

For non-branch instructions* 

First byte of operand 

Second byte of operand (if any) 
Operand section flag (A♦B»C,D,N,P) 

22-23 

28-31 

16-17 

22-25 

For branch instruction* 

Relative branch offset 

Absolute address of destination 

22-23 

25-26 

28-31 

16-1 7 

19-20 

22-25 

For bit test and branch instructions* 
First byte of operand 

Relative branch offset 

Absolute address of destination 

28-31 

22-25 

For directives like BSZ, EQU, ORG, etc 
Value of expression 

33-38 

27-32 

Label field 

40-45 

34-39 

Operation field 

46-53 

40-47 

Operand field; longer operands extend 
into the comment field 

55-132 

49-132 

Comment field 
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E.3 M6809 FORMAT 

The M6809 Macro Assembler will automatically print user-supplied sequence 
numbers in the left margin if they appear in the source file. 


COLUMN 


Seq # 

No Seq # 

CONTENTS 

1-5 

— 

User-supplied sequence number 

(decimal) 

7-11 

1-5 

Source line number; a five-digit 

decimal counter maintained by the 
assembler 

12 

6 

Program counter section flag (A=ASCT, 
B=BSCT, C=CSCT, D=DSCT, N=Named 
Common, P=PSCT) 

14-17 

8-1 1 

Current program counter 

19-20 

21-22 

13-14 

15-16 

First byte of machine operation code 
Second byte of op-code (if any) 

24-25 
26-2 7 
32 

18-19 

20-21 

26 

For non-branch, non-indexed 
instructions* 

First byte of operand 

Second byte of operand (if any) 
Operand section flag (A, 8, C, D, 
N, P) 

24-25 

27-28 

29-30 

32 

18-19 

21-22 

23-24 

26 

For non-branch, indexed instructions* 
Index post-byte 

First byte of operand 

Second byte of operand (if any) 
Operand section flag 

24-25 

26-2 7 
29-32 

18-19 

20-21 

23-26 

For branch instructions* 

First byte of relative branch 
offset 

Second byte of offset (if any) 
Absolute address of destination 

24-25 

27-28 

18-19 

2 1 -22 

For M6800 equivalent instructions* 

Second byte of translated 

instruction 

Third byte of instruction (if 


any) 
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29-30 

23-24 

Fourth byte of Instruction (if 
any) 

29-32 

23-26 

For directives like BSZ, EQU, ORG» 
etc* 

Value of expression 

34-39 

28-33 

Label field 

41-46 

36-40 

Operation field 

47-64 

41-48 

Operand field* longer operands extend 
into the comment field 

66-132 

60-132 

Comment field 
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E.4 CROSS REFERENCE FORMAT 


COLUMN 

1 


2 


4-7 

9-14 

16-? 


CONTENTS 


Symbol Type Flag: 

D - External definition 

N - Named common symbol 

R - External reference 

U - Undefined symbol 

M - Multiply defined symbol 

S - "SET" symbol 

blank - None of the above 

Symbol Section Flag 
blank - ASCT 
B - BSCT 
C - CSCT 
D - DSCT 
P - PSCT 

Hexadecimal value of symbol 

Symbol name 

Assembler-maintained source line numbers of 
symbol reference. The asterisk appears 
after the line number of a symbol's 
definition. If the symbol was undefined, 
the asterisk will appear after the symbol's 
last reference. 
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APPENDIX F 


M6800 MACRO ASSEMBLER/M6800 ASSEMBLER DIFFERENCES 


Several differences exist between the M6800 Macro Assembler and the M6800 
Co-resident Assembler. Obvious differences include such things as relocation, 
external references, external definitions, conditional assembly, extended 
expression evaluation (operators and parentheses), printing of titles on the 
source listing, printing of sequence numbers on the left side of the listing, 
macro definitions, and the M6801 instruction mnemonics. 

Other differences are not attributable to major new features of the Macro 
Assembler. These differences include: 

1. The "OPT 0" option is no longer required to generate an object file. 

The object file is created as a default. 

2. All expressions follow the normal rules of algebra rather than the 
strict left-to-right evaluation performed by the Co-resident Assembler. 

3. The NAM directive is not required. 

4. The symbol table space required for each symbol has changed from eight 
to ten bytes. In addition, if the cross reference option is in effect, 
an additional ten bytes are required for every four references to a 
symbol. 

5. The Macro Assembler requires more memory. 

6. In certain versions of the Macro Assembler, all of the Assembler 
options specified with the OPT directive can be specified on the command 
line that invokes the Assembler. This feature allows various options 

to be included or excluded without having to edit the source file. 

7. Some versions also allow the source listing to be directed to a diskette 
file and to direct the printing of error messages to the printer (no 
listing being produced). 

With the exception of the M6801 option, all of the above differences also apply 
to the M6805 and M6809 Macro Assemblers. 
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APPENDIX G 


USING THE MACRO ASSEMBLER 


The following paragraphs describe how to invoke the Macro Assembler from an 
MDOS diskette, an EDOS diskette, or from tape. Each section also includes an 
example of the command line format. After the Macro Assembler has been invoked, 
it will display a message of the following format: 

MDOS MACROASSEMBLER 03.00 
COPYRIGHT BY MOTOROLA 1977 

M6800 MACROASSEMBLER 2.2 
COPYRIGHT BY MOTOROLA 1978 

M6805 MACROASSEMBLER 03.00 
COPYRIGHT BY MOTOROLA 1978 

M6809 MACROASSEMBLER 03.01 
COPYRIGHT BY MOTOROLA 1978 

to indicate the version of the assembler (M6800 MDOS - first sign on display; 

M6800 EDOS or tape - second sign on display; M6805 MDOS - third sign on display; 
M6809 MDOS - fourth sign on display) and the current revision number of the 
assembler. 

G.l M6800/M6801 MDOS MACRO ASSEMBLER 

The M6800 Macro Assembler is invoked from the MDOS command line, as are other 
MDOS commands. However, the M6800 Macro Assembler requires that the system has 
a minimum of 24K bytes of memory. The format of the command line is: 

RASM <name l>[,<name 2>,...,<name n>] [;<options>] 

where <name i> are the names of source files. Each file name in the list of 
source files is in the standard MDOS file name format: 

<filename> [.<suffix>] [:<logical unit number>] 

The default values of "SA" and "0" are used if suffix and logical unit number 
are not explicitly entered. Up to twenty file names can be accommodated by the 
Assembler. If multiple source files are specified, only the last source file 
should contain the END directive. If an END directive is found in a file prior 
to the last one, the assembly will exclude any files after the END directive. 

The <options> may be one or more of the options listed in the following table. 

All options except those that control the destination of the source listing, the 
destination of the object file, and the printing of error messages on the printer 
if no listing is desired, can be specified from within the source program with 
the OPT directive. Certain options are automatically used as a default condition. 
These conditions can be reversed or overridden by preceding the option letter with 
a minus sign (-). The following options are recognized by the Assembler: 
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OPTION 


DEFAULT 


ATTRIBUTE CONTROLLED BY OPTION 


A 

-A 

C 

C 

D 

D 

E 

-E 

F 

F 

G 

-G 

H 

-H 

L 

-L 

L=#CN, 

-L 

L=<name>, 

-L 

M 

-M 

N=ddd, 

N=72 

0 

0 


0=<name>, 

0 

P=dd, 

P=58 

R 

-R 

S 

-S 

U 

-U 

X 

-X 

Z 

-Z 


Absolute MDOS-loadable object file output 
Printing of macro calls 
Printing of macro definitions 
Printing of macro expansions 
Printing of conditional directives 

Printing of generated code from FCB, FDB, and FCC direct 
Input initial heading from the console 
Print source listing on line printer 
Print source listing on console 

Print source listing into diskette file <name> (default 
suffix is "AL"; default logical unit is zero) 

Print error messages only on line printer 
Set printed line length to "ddd" (decimal) 

Create object file with name <name 1> and suffix "LX" 
(absolute EXORciser-loadable), suffix "RO" (relocatable) 
or "LO" (absolute MDOS-loadable) on same drive as <name 
of command line 

Create object file with name <name> 

Set number of printed lines per page to "dd" (decimal) 
Relocatable object file output 
Print symbol table 

Print unassembled code between conditional directives 
Print cross reference table 

Use M6801 instruction mnemonics instead of M6800 and 
create M6801 object output 


Certain options (L=, N=, 0=, P=) require a terminating comma only if other 
options follow. Options are normally specified without any intervening blanks 
or separators. The options "L" and "M" are mutually exclusive, as are "A" and 
"R". The "A" option is only supported by the MDOS version of the Macro Assemble 

Each symbol in the symbol table requires ten bytes. Thus, if the minimum of 24K 
bytes of memory is used, the Macro Assembler can accommodate about 195 (decimal) 
symbols. However, if the cross reference option is specified, the symbol table 
requirements differ. In this case, an additional ten bytes are required by each 
symbol for every four references to that symbol. If macro definitions are 
used (MACR directive), the available symbol table space will be smaller. 

Like other MDOS commands, the RASM command is sensitive to the BREAK and CTL-W 
keys of the system console. 

The following are examples of valid MDOS command lines that invoke the Macro 
Assembler: 

RASM SFILE1;LRX 

This command line causes the Macro Assembler to assemble the source 
file SFILE1.SA:7> in the relocatable mode ("R" option). A source 
listing will be directed to the system line printer ("L" option). 

At the end of the source listing, a cross reference table will be 
printed ("X" option). An object output file, SFILE1.RO:0, will also 
be produced automatically. 
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RASM FILEA:1;O=TEMP:0 

This command line causes the Macro Assembler to assemble the source 
file FILEA.SA:!. No source listing vn’ll be generated, regardless 
of the OPT L directives within the source file. An object file will 
be created on drive zero. The suffix of the file will be "LX" (if 

no OPT REL or OPT ABS is contained in source file) or "RO" (if OPT 

REL is contained in source file) or "LO" (if OPT ABS is contained 
in source file. 

RASM F1,F2,F3:1;L-0S 

This command line causes the Macro Assembler to assemble the three 
source files F1.SA:0, F2.SA:0, and F3.SA:1 as if they were one 
contiguous source file. A source listing is produced on the system 

line printer. No object output file will be created. A symbol 

table will be printed at the end of the source listing. 


RASM TEST;A 

This command line causes the Macro Assembler to assemble the source 
file TEST.SA:0. No source listing will be generated. An object file 
will be created on drive zero (0). Its name will be TEST.LO, and 
it will be in a format that can be loaded by MDOS. 


G.2 M6805 MACRO ASSEMBLER 

The M6805 Macro Assembler only runs under MDOS. It is invoked from the MDOS 
command line, as are other MDOS commands. The format of the command line is: 

RASM05 <name l>[,<name 2>,...,<name n>] [;<options>] 

With the following exceptions, the command line parameters are the same as 
described for the M6800 MDOS Macro Assembler (Paragraph G.l). 

1. The "Z" option does not exist. 

2. With 24K bytes of memory, the M6805 Macro Assembler can accommodate 
about 185 (decimal) symbols. 

G.3 M6809 MACRO ASSEMBLER 

The M6809 Macro Assembler only runs under MDOS. It is invoked from the MDOS 
command line, as are other MDOS commands. However, the M6809 Macro Assembler 
requires that the system has a minimum of 32K bytes of memory. The format of 
the command line is: 

RASM09 <name l>[,<name 2>,...,<name n>] [;<options>] 

With the following exceptions, the command line parameters are the same as 
described for the M6800 MDOS Macro Assembler (Paragraph G.l). 

1. The "Z" option does not exist. 

2. The "W" option exists and indicates that warnings should be printed. 
"-W" suppresses warnings. The default is to print warnings. 
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3. If the "M" command line option is specified, warnings as well as error 
messages are directed to the line printer. 

4. With 32K bytes of memory, the M6809 Macro Assembler can accommodate 
about 740 (decimal) symbols. 

G.4 M6800 EDOS MACRO ASSEMBLER 

The M6800 Macro Assembler is invoked from the EDOS command line, as are other 
EDOS commands. However, the RASM command requires that the system has a minimum 
of 16K bytes of memory. The format of the command line is: 

RASM,[<1ist>],[<object>],<name l>[,<name 2>,...,<name n>] 

where <list> specifies whether or not a source listing is to be produced, <objeci 
specifies whether or not an object file is to be produced, and <name i> (i=l to r 
are the names of EDOS source files. Each file name must be a valid EDOS file 
name (five characters). If multiple source files are specified, only the last 
file should contain an END directive. If an END directive is encountered prior 
to the last file, the assembly will not include files after the END directive. 

The <list> can be either the line printer (#LP), the system console (#CN), an 
EDOS file name, or null (indicated by a comma only). If no <list> is specified, 
no source listing will be produced. If an EDOS file name is used to receive the 
source listing, then no object file can be created on the diskette at the same 
time. 

The <object> can be either the line printer (#LP), the system console (#CN), an 
EDOS file name, or null (indicated by a comma only). If an EDOS file name is 
used to receive the object file, then no source listing can be created on the 
diskette at the same time. The line printer or system console should not be 
used if the program is being assembled with the relocatable option (OPT REL). 

The EDOS Macro Assembler does not support the M6801 instruction set or the 
printing of sequence numbers on the left. If sequence numbers are in the source 
file, they will only be printed if the OPT SE option is in effect. 

Each symbol in the symbol table requires ten bytes. Thus, if the minimum of 
16K bytes of memory is used, the Macro Assembler can accommodate about 270 
(decimal) symbols. However, if the cross reference option is used, the symbol 
table requirements differ. In this case, an additional ten bytes are required 
by each symbol for every four references to that symbol. If macro definitions 
are used (MACR directive), the available symbol table space will be smaller. 

Following are examples of valid EDOS command lines used to invoke the Macro 
Assembler: 

RASM,#CN,PR060,PROGS 

This command line will cause the file PROGS to be assembled. A source 
listing will be produced on the system console. The object file PROGO 
will also be created on the diskette. Both source and object files 
are on drive zero. 
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RASM,,PR0G0:1,PROGS 

This command line will cause the file PROGS to be assembled. However, 
no source listing will be produced. The object file, PROGO, will be 
created on drive one. 

RASM,#LP,,PR0G1,PR0G2,PROGS 

This command line will cause the files PROGl, PR0G2, and PROGS to be 
assembled as if they were one contiguous source file. A source 
listing is produced on the system line printer. No object file will 
be created. 


G.5 M6800/M6801 TAPE MACRO ASSEMBLER 


The tape version of the Macro Assembler is loaded via EXbug. When the EXbug 
prompt: 

EXbug V.R 

is displayed, the command 


LOAD 


should be entered. EXbug will respond with the prompt: 

SGL/CONT 

to which the operator should respond with an "S". The tape should then proceed 
to be loaded into memory. EXbug will display its prompt again after the load 
has completed. 

The Macro Assembler is given control via the command: 

600;G 

(either from MAID, if using EXbug version 1.1 or 1.2, or directly from EXbug, if 
using version 2.0). The Macro Assembler will then display a sign-on message, 
followed by the prompt: 


#LIST,#OBJECT: 

? 


The operator must respond with the proper device designators as follows: 


Designator 


Device 


#CN Console printer 

#CP Console punch 

#LP Line printer 

null No output desired 


For example, the operator response: 

#CN,#CP 


causes the source listing to be directed to the console printer, and the object 
file to be directed to the console punch. The operator response: 


#LP 
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causes the source listing to be directed to the line printer, and no object 
file to be created. The operator response: 


,#CN 

causes no source listing to be generated, and an object file to be displayed 
on the console printer. A null response for both devices (carriage return only) 
will cause neither a source listing nor an object file to be created. 

Next, the Macro Assembler will display the message: 

SOURCE DEVICE: 

? 

to which the operator must enter the device designator that contains his source 
input file. The console reader (#CR) or the EXORtape (high-speed paper tape 
reader) (#HR) is the only valid designator for the source device. The source 
tape must be loaded and ready to be read before this response is given. 

If an END directive is not encountered in the source file (i.e., a tape time-out 
occurred), then the assembler will redisplay the "SOURCE DEVICE" prompt, enablin 
the operator to load another source file. This process will continue until an 
END directive is encountered in a source file. If no source files contain an 
END directive, the operator can respond with the letter "E", followed by a 
carriage return to the "SOURCE DEVICE" prompt. This will end pass one of the 
assembler and will cause an error to be generated indicating that no END 
directive was encountered. 

When the END directive is encountered, or when the "E" is entered by the operate 
as explained above, the assembler will end pass one, and begin pass two. This 
is indicated by the following display: 

PASS 2 

SOURCE DEVICE: 

? 

The operator must then reload all of the source tapes in the same sequence as 
they were loaded during the first pass. The specification of the device is the 
same as during pass one. The termination of pass two is also the same as during 
the first pass. During pass two, the source listing and the object file, if 
specified, will be produced. 

After pass two is terminated, the assembler will display another question mark 
prompt (?) to indicate that it is ready to assemble another program. The source 
listing and object device designators should be entered at this point if another 
assembly is to occur. 

If the operator detects an error in an input line that he has entered prior to 
depressing the terminating carriage return, the CTL-X keys can be depressed to 
cancel the entire line, allowing a new line to be input; or the CTL-H keys can 
be depressed causing the previously entered character to be deleted. The 
character deleted is redisplayed on the console as positive feedback that it was 
removed from the input line. 
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Each symbol in the symbol table requires ten bytes. Thus, if the minimum of 
16K bytes of memory is used, the Macro Assembler can accommodate about 360 
(decimal) symbols. However, if the cross reference option is specified, the 
symbol table requirements differ. In this case, an additional ten bytes are 
required by each symbol for every four references to that symbol. If macro 
definitions are used (MACR directive), the available symbol table space will 
be smaller. 

The tape version of the Macro Assembler does not support the printing of 
sequence numbers on the left margin. If sequence numbers are contained in a 
file, they can only be printed with the OPT SE directive; then they will be 
printed in the right margin of the source listing. The tape version of the 
Macro Assembler does not support the relocatable option either. Thus, all 
directives dealing with program sections and relocatable features cannot be 
used. 
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APPENDIX H 


SAMPLE PROGRAMS 


The following example illustrates the various Macro Assembler directives 
that can be used in any program, regardless of whether or not it is assembled 
with the relocatable option. An attempt has been made to show all of the 
different types of constants and expression formats that can be used. Although 
the listing format shown is for the M6800 Macro Assembler, that is the only 
difference between that and the M6805 and M6809 Macro Assemblers for this example. 

The comments contained in the example serve to document what the different 
directives are used for. Chapter 4 describes all of the directives in detail, 
and should be consulted for a description of each directive, if necessary. 


HAGE 00 EXAMPI .SA»0 


00001 
00002 
00003 
00004 
00005 
00006 
00007 
00008 
00009 
00010 
00011 
00012 
00013 
0001 4 
00015 
00016 


* 

★ THIS EXAMPLE ILLUSTRATES THE USE OF THE VARIOUS 

★ ASSEMBLER DIRECTIVES THAT DO NOT INVOLVE 

★ PROGRAM RELOCATION. 

★ 

★ 


★ 

★ TURN ON OPTIONS TO PRINT SYMBOL TABLE AND TO 

★ GENERATE OBJECT LISTING FROM FCB, FDB, AND FCC 

★ 


OPT S.G 

★ 

★ USE DEFAULT VALUE OF PROGRAM COUNTER 

★ FOR INITIAL ORIGIN 

★ 


* 


00017 

00018 

00019 

00020 


★ BSZ — BLOCK STORAGE OF ZEROES 

★ FIRST FORM USES SIMPLE CONSTANT 

★ SECOND FORM USES COMPLEX EXPRESSION 

★ 


00021 A 0000 
00022A 0005 
00023 
00024 
00025 
00026 
00027 
00028 
00029 


0005 A BSZ 5 .FIVE BYTES 

0006 A LABELO BSZ $10*2/2-$l 0+977-760+101 B . 6 BYTES 

* 

★ EQU ~ ASSIGN VALUE TO LABEL. FIRST FORM USES 

★ PROGRAM COUNTER IN EXPRESSION. SECOND 

★ FORM USES * AS BOTH PC AND MULTIPLY 

★ OPERATOR. THIRD AND FOURTH FORMS USE 

★ SHIFT OPERATOR. 

★ 


00030 


OOOB A TAG I EQU * 


USE OF PROGRAM COUNTER 
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00031 


003C 

A 

TAG2 

EQU 

***/2 

. CALC PC*PC/2 

00032 


OBOO 

A 

TAG3 

EQU 

TAGl!<8 

. SHIFT LSB INTO MSB 

00033 


OB 00 

A 

TAG4 

EQU 

TAGl !<(2 

r3) . SAME AS TAG3 

00034 




★ 





00035 




★ 

FCB 

— FORM 

CONSTANT 

BYTE 

00036 




★ 





00037A 

000 B 

OC 

A 

TAG5 

FCB 

12 

. FORM A SINGLE BYTE 

00038A 

OOOC 

OA 

A 



FCB 

10,$10,&10,@10,%10,'l,^0,TAG3!>8,- 

A 

OOOD 

10 

A 






A 

OOOE 

OA 

A 






A 

OOOF 

08 

k 






A 

0010 

02 

A 






A 

0011 

31 

A 






A 

0012 

30 

A 






A 

0013 

OB 

A 






A 

0014 

FF 

A 






00039A 

0015 

OA 

A 



FCB 

10,,,20 

. USE OF NULL OPERAM)S 

A 

0016 

00 

A 






A 

0017 

00 

A 






A 

0018 

14 

A 






00040 




★ 





00041 




★ 

FDB 

— FORM 

CONSTANT 

DOUBLE BYTE 

00042 




★ 





00043A 

0019 

OOOC 

A 



FDB 

12 

. FORM A DOUBLE BYTE 

00044A 

001 B 

000A 

A 



FDB 

10,$10,&10,@10,%10,'l ,-'0,TAG3!>8,- 

A 

00 ID 

0010 

A 






A 

00 IF 

OOOA 

A 






A 

0021 

0008 

A 






A 

0023 

0002 

A 






A 

0025 

0031 

A 






A 

0027 

0030 

A 






A 

0029 

OOOB 

A 






A 

002 B 

FFFF 

A 






00045A 

002D 

OOOA 

A 



FDB 

10,,,20 

. USE OF NULL OPERANDS 

A 

002F 

0000 

A 






A 

0031 

0000 

A 






A 

0033 

001 4 

A 






00046 




★ 





00047 




★ 

FCC 

— FORM 

CONSTANT 

CHARACTER STRING 

00048 




★ 





00049A 

0035 

41 

A 



FCC 

5,ABCDE 

. STRING «ABODE" 

A 

0036 

42 

A 






A 

0037 

43 

A 






A 

0038 

44 

A 






A 

0039 

45 

A 






o 

8 

o 

> 

003A 

41 

A 



FCC 

5,A 

. STRING "A '• 

A 

003B 

20 

A 






A 

003C 

20 

A 






A 

003D 

20 

A 






A 

003 E 

20 

A 






00051 




★ 





00052 




★ 

TURN 

OF GENERATION OF OBJECT CODE LISTING FRON 

00053 




★ 





00054 






OPT 

NOG 

• 
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00056 




* 



00056A 

003F 

41 

A 

STR_2 

FCC “ABC #$%& 

'’() STRING*' 

00057A 

0051 

42 

A 

STR$ 1 

FCC ABCDEFA 

. STRING "BCOEF" 

00058 




* 



00059 




* REORIGIN THE PROGRAM 

COUNTER 

00060 




★ 



0006.1 A 

0100 




ORG $ 100 

. PC=256 (DECIMAL) 

00062 




★ 



00063 




★ USE 

SPC DIRECTIVE TO 

SKIP 3 LINES 

00064 




★ 



00066 




★ 



00067 




★ HMB 

— RESERVE MEMORY 

BYTES 

00068 




★ 



00069A 

01 00 

0005 

A 

LOG, 

RMB 5 

. FIVE BYTES 

00070 




★ 



00071 




★ SET 

-- INITIALIZE TEMPORARY VALUE TO SYMBOL 

00072 




★ 



00073 


0001 

A 

SKIPS! 

SET 1 

. CHANGEABLE SYMBOL 

00074A 

0105 

0001 

A 


RMB SKIPSl 

. ONE BYTE 

00075 


0002 

A 

SKIPS! 

SET SKIP$1+1 

• 

000 7,6A 

0106 

0002 

A 


RMB SKIP$1 

. TWO BYTES 

00077 


0003 

A 

SKIPS! 

SET SKIP$1+1 

• 

00078A 

0108 

0003 

A 


RMB SKIP$1 

. THREE BYTES 

00079 




★ 



00080 




★ END 

—- END OF PR(X3RAM 

00081 




★ 



00082 





END 


TOTAL ERRORS 

00000— 

-00000 



LA8EL0 

0005 

L(x:. 

0100 SKIPSl 0003 STR$1 

0051 STR_2 003F 

TAGl 

000B 

TAG2 

003C TAG3 OB00 rAG4 

OBno TAG5 0008 
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H.l M6800 PROGRAMS 


The next two examples illustrate the use of the relocation scheme. The first 
program is a "main" program that calls a subroutine which is assembled external 
to the main program. The main program sets up the parameters prior to calling 
the subroutine. These two examples also show the format of the program listing 
as well as the usage of the various addressing modes and relocatable directives 
First, the main program is shown. 


PAGE 001 RELMflIH . 

SR 

1 

00001 




Sf! 

00002 




* THIS EXAMPLE ILLUSTRATES THE USE OF THE 

00003: 

00004 

00005 




* RELOCATABLE DIRECTIVES. 

00006 





00007 




■* TURN ON RELOCATABLE AND CROSS REFERENCE 

00008 

00009 




* TABLE OPTIONS 

* 

00010 




OPT REL.. CRE 

00011 




* 

00012 




=+= DEFINE THE EXTERNAL REFERENCES TO A 

00012 




>»= MOVE CHARACTER SUBROUTINE. "MOVE" 

00014 




=+= IS THE ENTRV POINT TO 

00015 




=+= THE ROUTINE.: "FROM" IS A POINTER 

00016 




■* TO A SOURCE STRING.: AND "TO" IS A 

0001? 




+ POINTER TO A DESTINATION STRING. 

00018 




:4: 

00019 




XREF BSCT : FROM.. TO.. PSCT : MOVE 

00020 




* 

00021 

00022 




+ DEFINE ENTRV POINT INTO EXBUG 

Jf: 

00022 


FCF4 

R 

EXBUG EQU t-FCF4 

00024 





00025 




* DEFINE A STRING.. BUFFER.. AND STACK 

00026 

00027 




* IN THE DATA SECTION 

>4: 

00028D 

0000 



DSCT 

00029D 

0000 

001D 

R 

RMB 29 . STACK AREA 

00030D 

001D 

0001 

R 

STACK RMB 1 . TOP OF STACK 

00021D 

001E 

57 

R 

STRING FCC "WILL BE MOVED TO BUFFER" 

00022 


0025 

D 

STREND EQU ^4= , END OF STRING 

00022D 

0025 

0050 

R 

BUFFER RMB 80 . DESTINATION BUFFER 

00034 




:4! 

00025 




>4: DEFINE THE MAIN PROGRAM IN THE 

00036 




:4: PROGRAM SECTION 

00037 





00028P 

0000 



PSCT 

00029 


0000 

P 

START EQU ^4= 

00040P 

0000 

8E 001D 

D 

LDS #STACK . INITIALIZE STACK POINTER 
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00041P 

0002 

CE 

001E 

D 

LDX 

#STRING 

. SOURCE STRING 

00042P 

0006 

DF 

00 

fi 

STX 

FROM 


00042P 

0008 

CE 

0025 

D 

LDX 

#BUFFER 

. DESTINATION AREA 

00044P 

000B 

DF 

00 

fl 

STX 

TO 


00045P 

000D 

C6 

17 

R 

LDRB 

#STREND- 

STRING . LENGTH TO MOVE 

00046P 

000F 

BD 

0000 

fl 

JSR 

MOVE 

. ROUTINE TO MOVE 

00047P 

00048 

0012 

7E 

FC:F4 

fl 

JMP 

EXBUG 

. EXIT TO DEBUG MONITOR 

00049 



0000 

P 

END 

START 

. STARTING EXECUTION ADDRE 


TOTRL ERRORS 00000—00000 


D 0025 
FCF4 
RB 
RP 

D 001D 
P 0000 
D 0025 
D 001E 
RB 


BUFFER 00022*00042 
EXBUQ 00022*00047 
FROM 00019*00042 
MOVE 00019*00046 
ST flCK 00020*0004£i 
STRRT 00029*00049 
STREND 00022*00045 
STRING 00021*00041 00045 
TO 00019*00044 
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Next, the "MOVE" subroutine is shown. 


PAGE 001 MOVE .SA*1 


0000 i 
00002 
00003 
00004 
00005 
00006 
00007 
00008 
00009 
00010 
0001 I 
00012 
00013 


★ 

★ 

★ 

* 

★ 

★ 

★ 

★ 

★ 

* 

★ 


THIS EXAMPLE IS THE "MOVE^' HOUTIiVE 
CALLED BV THE PREVIOUS EXAMPLE. 


OPT 


RELtCRE 


DEFINE THE EXTERNAL SYMBOLS 
XDEF MOVE,FROM,TO 

RESERVE SPACE IN DIRECT ADDRESSING AREA 
FOR THE SOURCE AND DESTINATION 


00014 




★ POINTERS. 



00015 




■k 




00016B 

0000 




BSCT 



00017B 

0000 


0002 

A FROM 

RMB 

2 

SOURCE POINTER 

00018B 

0002 


0002 

A TO 

RMB 

2 

DESTINATION POINTER 

00019 




★ 




00020 




★ DEFINE THE 

"MOVE" SUBROUTINE 

00021 




★ ENTERED WITH "B” = NO. 

BYTES IN SOURCE 

00022 




* STRING. «FROM»' AND “TO" SET UP BY 

00023 




★ THE 

CALLING 

PROGRAM. 


00024 




* 




00025P 

0000 




PSCT 



00026 



0000 

P MOVE 

EQU 

^ • 

ENTRY POINT 

00027P 

0000 

DE 

00 

B 

LDX 

FROM 

PICK UP SOURCE ADDRESS 

00028P 

0002 

A6 

00 

A 

LDAA 

o,x 

GET SOURCE BYTE 

00029P 

0004 

08 



INX 

• 


00030P 

0005 

DF 

00 

B 

srx 

FROM 

SAVE INCREMENTED POINT 

0003 IP 

0007 

DE 

02 

B 

LDX 

TO 


00032P 

0009 

A7 

00 

A 

STAA 

0,X 

STORE DESTINATION BYTE 

00033P 

000 B 

08 



INX 

• 


00034P 

OOOC 

DF 

02 

B 

srx 

TO 

SAVE INCREMENTED POINT 

00035P 

OOOE 

5A 



DECS 

• 

DECREMENT COUMTER 

00036P 

OOOF 

26 

EF 0000 

BNE 

MOVE 

LOOP UNTIL ZERO . 

00037P 

001 1 

39 



RTS 


RETURN TO CALLER 

00038 




★ 




00039 





END 



TOfAL ERRORS 

00000—( 

00000 




DB OOOO 

FROM 

00010 

00017*00027 00030 


DP 0000 MOVE 

00010 

00026*00036 



DB 0002 

TO 


00010 

00018*00031 00034 
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H.2 M6805 PROGRAM 


The following example illustrates the use of the bit instructions. 


PAGE 001 H2 . SR; 1 


00010 

00001 








00020 

00002 





=+^TSTBIT CHECKS 

; AN I/O BIT AND SETS 

00030 

00003 





+OR CLEARS SOME BIT FLAGS 

00040 

00004 





=+= DEPENDING ON 

STATE OF I/O BIT 

00050 

00005 





:4: 



00060 

00006 



0004 

R 

INPUT 

EQU 

$4 INPUT DATA 

00070 

00007R 

0040 





ORG 

$40 

00080 

00008R 

0040 


0001 

R 

FLAGl 

RMB 

1 BIT FLAGS 

00090 

00009R 

0041 


0002 

R 

FLAG2 

RMB 

2 BIT FLAGS 

00100 

00010R 

0680 





ORG 

$80 

00110 

00011 



0080 

R 

TSTBIT 

EQU 


00120 

00012A 

0080 

0? 

04 06 

0089 


BRCLR 

3.. INPUT.. OFF 

00130 

00013 





=+= INPUT 

BIT IS 

ON “ SET SOME BIT FLAGS 

00140 

00014A 

0083 

lA 

40 

R 


BSET 

5.. FLAGl 

00150 

00015A 

0085 

14 

40 

R 


BSET 

2.. FLAGl 

0£ll60 

00016A 

0087 

20 

06 

008F 


BRA 

CONI 

00170 

0001? 





INPUT 

BIT IS 

OFF — CLEAR SOME BIT FLAG 

00180 

00018R 

0089 

11 

41 

R 

OFF 

BCLR 

0.. FLAG2 

00190 

00019A 

008B 

ID 

41 

R 


BCLR 

6.. FLAG2 

00200 

00020A 

00SD 

IF 

41 

R 


BCLR 

7'',. FLAG2 

00210 

00021 



008F 

R 

CONT 

EQU 

* CONTINUE PROCESSI 

00220 

00022 






END 


TOTAL 

ERRORS 

00000 

1-00000 






H-7 




H.3 M6809 PROGRAMS 


The following example illustrates how a program can take advantage of the 
direct addressing mode without being a relocatable program using BSCT. 


00001 





★ 




00002 





★THIS 

FR(X3RAM 

HANDLES 

AN INTERRUPT FROM 

00003 





★ 

AN INPUT OEVICE 

— IT GETS CONTROL ON 

00004 





★ 

AN IRQ 

FROM A PI A, INPUTS A CHAR, 

00005 





★ 

CLEARS 

THE INTERRUPT, PUTS THE CHAR 

00006 





★ 

IN A BUFFER, INCREMENTS TrlE BUFFER 

00007 





★ 

PTR, TESTS FOR 

END OF LINE, RESTORES 

00008 





★ 

REGISTERS, AND 

RETURNS 

00009 





★ 




000lOA 

2000 





ORG 

$2000 


0001 1 



0000 

A 

EOL 

EQU 

$D 

CR IS END OF LINE li 

000I2A 

2000 


00 

A 

MODEM 

FCB 

0 


000I3A 

2001 


2003 

A 

BUFFTR FOB 

BUF 


00014A 

2003 


0064 

A 

BUF 

RMB 

100 


00015 





★SET 

UP DP PSEUDO REG 

. FOR ASSEMBLER 

00016 



0020 

A 


SETOP 

$20 


00017 





★set 

UP DP REGISTER FOR EXECUTION 

00018A 

2067 

86 

20 

A 


LDA 

#$20 


00019A 

2069 

IF 

8B 

A 


FFR 

A,DP 


00020A 

206B 

96 

00 

A 


LDA 

MODEM 

CLEARS PI A IRQ 

00021 A 

2060 

9E 

01 

A 


LDX 

BUFPTR 

GET PTR 

00022A 

206F 

A7 

80 

A 


STA 

,x+ 

STORE CHAR 

00023A 

2071 

9F 

01 

A 


STX 

BUFPTR 

UPDATE PTR 

00024A 

20/3 

81 

00 

A 


CMPA 

#EOL 

END OF LINE? 

00025A 

20/5 

27 

01 

2078 


BEQ 

EOLGP 

IF YES, MORE TO DO 

00026A 

20 77 

3B 




RTI 


ELSE, RETURN 

00027A 

2078 

20 

FE 

2078 

EOLGP 

BRA 

★ 


00028 






END 




TOTAL ERRORS 00000—00000 
TOTAL WARNINGS 00000—00000 
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The following example illustrates how position independent code can be 
generated by using the PCR indexing mode. 


00001 

00002 

00003 

00004 

00005 

00006 


* 

★SUBSEQ SUBTRACTS A SEQUENCE OF DECIMAL 

★ DIGITS (IY) FROM ANOTHER SEQUENCE 

★ OF DECIMAL DIGITS (IX) AND STORES 

★ THE RESULT (US) 

★ ALL STRINGS ARE COUNT BYTES LONG 


00008A 

0000 


99 

A 

MINUEN 

FCB 

$99,$99, 

$99,$99,$99 

00009A 

0005 


99 

A 


FCB 

$99, $09, 

$00,$00,$00 

0001OA 

OOOA 


01 

A 

SUBTRA 

FCB 

$01,$09, 

$00,$00,$00 

0001 1 A 

OOOF 


99 

A 


FCB 

$99,$00, 

$54,$32,$l1 

000I2A 

0014 


OOOA A 

RESULT 

RMB 

10 


00013 



OOOA A 

COUNT 

EQU 

10 


00015A 

00 IE 

30 

8C 

E9 


LEAX 

MINUEN+COUNT,PCR 

00016A 

0021 

31 

8C 

FO 


LEAY 

SUBTRA+COUNT,PCR 

00017A 

0024 

33 

8C 

F7 


LEAU 

RESULT+C()UNT,PCR 

00018A 

0027 

C6 

OA 

A 


LDB 

#COUNT 


00019A 

0029 

8D 

02 

002D 


BSR 

SUBSEQ 


00020A 

002 B 

20 

FE 

002B 


BRA 

★ 


00021 





★ 




00022A 

00 2D 

1 A 

01 


SUBSEQ 

SEC 


SET CARRY 

00023A 

002 F 

34 

01 

A 


PSHS 

cc 

CARRY TEMP 

00024A 

0031 

86 

99 

A 

LOOPS 

LDA 

#$99 

THE TEN^S COMPLEMENT 

00025A 

0033 

AO 

A2 

A 


SUBA 

Ot-Y 

NO CARRY POSSIBLE 

000 26A 

0035 

35 

01 

A 


PULS 

CC 

THE SAVED CARRY 

00027A 

0037 

A9 

82 

A 


ADC A 

0,-X 

DO A BINARY ADD 

00028A 

0039 

19 




DAA 


BACK TO BCD 

00029A 

00 3A 

34 

01 

A 


PSHS 

CC 

SAVE THE CARRY 

00030A 

003C 

A 7 

C2 

A 


STA 

0,-U 

STORE THE RESULT 

00031 A 

003 E 

5A 




DECB 


DONE? 

00032A 

003F 

26 

FO 

0031 


BNE 

LOOPS 

IF NOT, GO AGAIN 

00033A 

0041 

35 

81 

A 


PULS 

CC,PC 

CLEAN UP STACK AND RET 

00034 






END 




TOTAL ERRORS 00000—00000 
TOTAL WARNINGS 00000—00000 
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